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Summary of Amendments 
I Independent Component Release of IBM 3800 Printing Subsystem Support 

I Technical Newsletter GN33-9230 documents changes to support the IBM 3800 Printing 
I Subsystem under DOS/VS. 

/ 

Technical Newsletter GN33-9226 corrects errors in the base publication and documeiii.!:. 
the restoring of DOS/VS to minidisk under VM/370. 

Release 34 

Edition GC33-5377-6 documents: 

• Full support for the IBM 3350 and IBM 3330-11 

• Support of the IBM 3277 as operator console 

• Support of the IBM 3540 as IPL connunication device 

• Inclusion of functions of the COPYSEBV prograa into the C0RG2 program and 
the removal of the COPYSERV program from DOS/VS 

• Improvement of initial program load through tt^e use of an IPL communication devi o 
list 

• Integration of support information on System/370 CPU Models 135-3, 138, 145-3, and 148 
and on the IBM 3203*4 printer 

• Removal of POWER/VS generation information that was provided in nodule 2 of earl.rer 
editions of this manual; this information is now included in DOS/VS POWER/VS 
Installation Guide and Reference ,, GC33-6048 

• EREP enhancements for CPO Models 135, 138, and 158 

In addition, corrections and editorial changes have been made to improve the manucil' 
usability. 



Release 33 

Edition GC33-5377-5 documents: 

Installation improvements 

POWER/VS enhancements 

VSAH enhancements 

Access Method Services enhancements 

New utility programs 

Cardless system support 

Minor changes and corrections throughout the manual 

Note that Module 1, "Planning and Procedures", has been revised entirely. 



Release 32 

Edition GC33-5377-4 documents: 

• Cross-partition event control 

• CIL patch program (PDZAP) 

• Highspeed standalone dump 

• Fast COW translation 

• Minor changes and corrections throughout the manual 



Preface 



The information in this publication is of particular interest to anyone responsible for 
the planning and/or impleitientation of system generation and maintenance for DOS/VS. This 
includes installation managers, system analysts, prograiritiers, and machine operators. 

Familiarity with the following system programs and facilities is invaluable when using 
this publication: 

• Control programs (supervisor, job control,, and IPL) 

• System service programs (linkage editor and librarian) 

• Input/Output Control System (IOCS) logic modules. 

The storage estimates given in this publication are within 157o of actual requirements. 

MODULAR ORGANIZATION OF THIS MANUAL 

This publication is in a modular format that enables you to discard unwanted modules and 
to insert system generation modules from program product documents. Thus, you can easily 
prepare a system generation document for your own installation. 

Although the pages are numbered consecutively throughout the book, each module is 
self-contained. A numbered tab on the right-hand edge of the page indicates the 
beginning of each new module. If module volume warrants, a Module Outline and 
Module Index is provided. 

The total publication has a General Contents and a General Index . These refer you to 
the individual module numbers. Figure numbers throughout the publication are in the 
form: Figure 1-3, where 1 is the module number and 3 is the figure number within the 
module. 

Each module in this publication is a collection of information about a particular 
component or related topics- The modules, numbered from 1 to 25, are grouped as follows: 

Module 1: Planning and procedures information 

Module 2: POWER/VS 

Module 3: Installation Verification Procedures (IVP) 

Modules 4-6: Emulator Programs 

Modules 7-16: I/O Components 



Module 17 
Module 18 
Module 19 
Module 20 
Module 21 
Module 22 
Module 23 
Module 21 
Module 2 5 



VSAM 

Assembler 

System aids (OLTEP) 

BTAM 

QTAM 

VTAM 

SSS 

System Utilities 

EREP 



Prerequisites for a thorough understanding and effective use of this publication are; 

D OS/VS System Management Guide , GC33-5371 

DOS/VS System Control Statements , GC33-5376 

DOS/VS Supervisor and I/O Macros , GC33-5373 

DOS/VS Operating Procedures . GC33-5378 

DOS/VS Messages , GC33-5379 

DOS/VS System Utilities , GC33-5381 

lLi''j Sv.->-ut-)i!/37C Suusyst-t^Hi 3m-:por-c Servicc-s U^trr's Guide , GC30-302/' 

Guiue to tlie DOS/VS Asi^fcmblfcr , Gr33-4024 

J'joviii^ iictii ncdel 20 to DCS/VS , GC33- 53Sb 
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CHUN 53 

Clear data cell 

core image library blocks 1 06 

modules, number of 106 

phases, number of 106 

clear disk 

core image library blocks 106 

modules, number of 106 

phases, number of 106 

coding specifications for // ASSGN 63 

command chaining (CCHAIN) 45 

common librarian modules 118 

compile a suuervisor 122 

comjjontnt requirtiacnts 103, 108 

coinponen t sizes , . . io3 

computing the size of a supervisor 70 

CONFG macro. 35 

configuration of IBM-supplied 

supervisors. •J20 

configuration, system.. 20 

considerations for system 

generation 39 

console buffering (CBF) 37 

copy disk or data cell to tape 

core image library blocks io6 

modules, number of -jQg 

phases, number of -]Qg 

copy disk to card 

core image library blocks, 106 

modules, number of ^oe 

phases, number of 106 
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copy disk to disk 

core image library blocks 1C6 

nodules, number of..., 106 

phases* number of. 10^ 

copy file and maintain gbject 
module (OBJMAINT) utility 

core image library blocks 106 

modules, number of....... lOo 

phases, number of 106 

copy selectively to merye libraries 
(Ste COhGV) 

core image library. 

comFOnents. 103 

COBGZ ,.. 104 

CSERV 10 4 

directory capacities 75,85 

DSERV. 104,119 

DUMPGEN 105, 131 

EREP 103 

ESERV 103 

IBM-supplied 25 

IPL and buffer load 104,115 

job control 104,118 

linkage editor 104,118 

MAI NT 104,118.1 

MCAR/CCH 10 5, 123 

PDAID 105,131 

PDSDM 105, 132 

PSEHV 104,119 

RSERV 104,119 

SSERV 104, 119 

standard system dump 103,129 

supervisor macros 105 

supervisor nucleus 120 

translating system dump 10 3,129 

CORGZ 

core image library blocks 118.1 

examples of use 80,90,91 

link-edit statements 118.1 

modules names • 118.1 

modules, number of 104 

phase names 118.1 

phases, number of 104 

creating system files. 75 

page data set 75 

recorder file 76 

hard-copy file 77 

cross-partition event control 45 

CSERV 

core image library blocks 104 

link-edit statements 119 

module naunes 119 

modules, number of 104 

phase names ....« 119 

phases, number of •• 104 

CYL. . , 57 

cylinder capacity, system library 75 



D2311 51 

D231I* 51 

D2321 51 

D2400 * 51 

D3330 51 



D3340 51 

D3350 51 

D3410 51 

D3420 51 

D3540 51 

i D3 800 51 ,68 

D3886 51 

DASDFP. • 39 

data cell to tape 

core image librair/ blocks 106 

modules, number of 106 

phases, nuicber of........... 106 

DATE 37 

DEC 37 

DECK 37 

declaring SYSRES libraries as 

private libraries.. 90,97 

define labels 89,101 

define the page data set (DPD) 57 

delete procedure.. 86 

delete unwanted library entries. 92 

device address specification 56 

dtvice codes for CVCGEN 60 

DIMOD 

Storage requirements. •.•...•....... .. 111 

directory capacities, system 75,85 

DISK 46 

disk initialization 81,85 

disk initialization bypass 82 

disk to card 

core image library blocks.. 106 

modules, number of 106 

phases, number of 106 

disk to disk 

core image library blocks............ 106 

modules, number of 106 

phases, number of.. 106 

disk ERP 103,130 

core image library blocks 103 

disk to tape 

core image library blocks 106 

modules, number of........ 106 

phases, number of 106 

display operator console (DOC) 39 

distribution tape processing 

without an operational DOS/VS. 81 

display operator console.. 103,130 

core image library blocks 103 

modules, number of.... 103 

phases, number of 103 

relocatable library blocks 103 

source statement library blocks...... 103 

display the source of supervisors... 97,122 

DOC 39 

DOS/VS component sizes and library 

requirements 103 

DPD macro ........•• ..••. 57 

DSERV 

core image library blocks..... 104 

link-edit statements 119 

modul e names 119 

modules, number of 104 

phase names 119 

phases, number of....... 104 

DTFCD (define the file card) , size 

of table 110 

DTFCN (define the file console)........ 112 
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DTFDI (define the file device 
independent system units) Ill 

DTFPH (define the file physical 
IOCS), size of table 112 

DTFPR (define the file printer), 
size of table 111 

DTFSR (define the file serial 
device), size of table.., 112 

DUMP 37 

DUMPGEN 

core image library blocks 105 

link-edit statements 131 

modules 131 

modules, number of 105 

phases 121 

phases, number of 105 

relocatable library blocks 105 

dumps 

page data set... 105,132 

standard system dump 129 

translating system dump 129 

DVCGEN macro 53 

DVCTYP 53 

E 

ECPREAL 39 

EDECK 37 

emulator generation 25 

end of supervisor macrc, SEND 57 

environmental recording, editing, 

and printing program (see EREP) 
EREF 

core image library blocks 103 

modules, number of 103 

phases, number of 103 

ERRLOG 34 

error recovery procedtares 

disk (DKE) 130 

tape (TPE) 131 

error statistics 

by tape volume..... 44 

2495 tape cartridge reader 43 

ERRC 39 

ERRS 37 

ESERV 

core image library blocks 103 

modules, number of 103 

phases, number of ; 103 

relocatable library blocks 103 

EU 34 

EVA 39 

example for system generation........... 93 

EXIT ^^5 

F 

failure in generating a system 102 

fast CCW translation 40 

fast copy disk volume utility 
(FASTCOPY) 

core image library block 106 

examples of use 80,90,102 

modules* number of 106 

phases, number of ........... 106 

source statement library blocks 106 



source statement library books 106 

FASTTR 40 

FETCH performance 27,40 

FOPT macro 38 

forced macros 59 

FP 36 

FliPGh 52 

Fn 49 

FnR 50 

G 

GETVIS 40 

GETVIS area in SVA 48 

I GRFIxxxx phases 117 

H 

hard- copy file 77, 10 

highspeed standalone dump 132 

HISTLIST 91 

HIST macro description (see the 
section "System Utilities*) 

I 

I/O configuration, SYSGEN examples 03 

IBM-supplied 

core image library... « • 25 

procedure library 25 

relocatable library 25 

source statement library 25 

supervisors 26,120 

IBM DOS/VS distribution for DASD 

and tape users 77 

ID. 34 

IDRA 40 

I lEBIMAGE {utility for 3800) 117 

initialize and restore programs 

bypass initialize disk 62 

initialize disk..... 82 

restore IBM tape to disk 81,85,95 

initialize data cell 

core image library blocks. 106 

phases, number of.......... 106 

initialize disk 

core image library blocks..... 106 

phases, number of 106 

initialize tape 

core image library blocks..... 106 

phases , number of 106 

IOCS 

core image library blocks 104 

IOCS macros 108 

IOCS modules assembly listing 99 

IOCS modules cataloging 100 

IOCS modules required by compilers... 89,99 

lODEV 52 

lOTAB macro 51 

IPL and buffer load (1403U, 3203, 
3211, and 5203 printers) 

core image library blocks 104 

link-edit statements 115 

module names 115 

modules, number of 104 

phase names 115 
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phases, number of 104 

IT 40 

IVP assembly example 102 



JA HO 

JALIOCS 41 

JIB 4 52 

job accounting interface 40 

job control 

core image library blocks 104 

link-edit statements 1ig 

modul e names 118 

modules, number of 104 

phase names 118 

phases, number of 104 

L 

labels 8 9,101 

librarian programs 118.1 

libraries 

avoiding loss of 90,98 

directory capacities of 75,85 

maintenance of 78,89 

not restored 85 

on SYSRES file 77 

size calculation and allocation 

for 73,85,92 

status i nf ormation of 90 

system 25 

track capacities of.. 75 

libraries on SYSRES file 77 

library maintenance 78,80,b9 

adding unique entries 92 

creating a third library 92 

deleting unwanted entries 92 

merging an entire library 9z 

merging entries into existing 

libraries 92 

merging two libraries ^2 

programs 80 

replacing identical entries 92 

lijjtaxy requirements 103 

LINES 37 

linkage editor 

core image library blocks 104 

link-edit statements 118 

module names 118 

modules, number of 104 

phase names 118 

phases, number of 118 

work files.., 104 

link-edit procedure 86 

LIST 37 

listings 28 

list system history (HISILIST) utility 

program 91 

LISTX 37 

loading the SDL 112 

loading the SVA 48,112 

loading VSAM phases 49 

LOAD performance - 27,40 

LOG 38 

logical units, maximum per 
partition 51 



LSERV 

core image library blocks 105 

link-edit statements 13^ 

module names 1j2 

modules, number of 105 

phase names 1J/ 

phases, number of... lO::* 

relocatable library blocks 105 

M 

machine requirements for cardless 
systems.. 30 

machine requirements, minimum 31 

macros lor generating a supervisor 33 

macros, IBM-supplied 

ALLOC 49, 1z2 

^djLOCR 50, 122 

ASSGN 55,122 

BDYBOX 1^2 

CCB 108 

CDMOD 109 

CHECK 109 

CHKPT 130 

CLOSE 109 

CLOSER 109 

CNTRL 105 

CONFG , 3 6,122 

CRTAEX 130 

CRTAWT 130 

CRTGEN 1^3,130 

CRTIO 130 

CRTSAV 123, 13C 

DIMOD 10 5,111 

DISP 1^2 

DPD 57,122 

DTFBG 108 

DTFCD 108,110 

DTFCN 108,112 

DTFDI 10 8,111 

DTFEN 1C8 

DTFPH 108,112 

DTFPR 10 8,111 

DTFPT 1 C8 

DTFSR 108 

DVCGEN 53, 122 

ERET 1 C6 

EXCP 108 

FEOV - 103 

FEOVD 108 

FCPT 38,122 

FREE , 1 C8 

GET 108 

IJLQDSCT 123 

IJLgTSVC 1 z3 

lOINTER 122 

lOTAB 51,122 

ISTAVT 122 

LBRET 108 

MAPCOMR 1^2 

MAPERPIB 122 

MAPLOWC 122 

MAPPUB2 122 

MCRAS 122 

NOTE >08 

OPEN 108 

OPENR 108 

PIOCS 46, 122 
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POINTR,, 108 

POINTS 10 8 

POINTW 108 

PRNCD Ill 

PRTOV 108 

PUT 108 

PUTR 130 

I QSETPRT 117 

READ 108 

RELEASE 108 

RELSE 108 

SECTVAL 10 8 

SEND 57,122 

SEOV 108 

I SETPRT 117 

SGAM , 122 

SGCCWT 122 

SGDFCH , 122 

SGDSK 122,130 

SGEND 122 

SGPMAIN 122 

SGPOPT 122 

SGPSUB 122 

SGSCVRT 122 

SGSVC 122 

SGSVCX 122 

SGTHAP . 122 

SMICR 122 

I SPLIST 117 

STDJC 37,122 

SUPVR .., 33,122 

SYSIO 122 

TRUNC 108 

TTIMER 108 

VSTAB 47,122 

WAITF 108 

WRITE , 108 

macros required and forced*.. 59 

main page pool size. 50 

MAINT 

core image library blocks..... 104 

link-edit statements 119 

module names. 118.1 

modules, number of 104 

phase names... 118.1 

phases, number of 104 

maintain system history (PTFHIST) 

core image library blocks*... • 106 

examples of use •.••• ...102,106 

linking 102 

macro description Csee the 
section "System Utilities*) 

modules, number of • 106 

phases, number of 106 

source statement library blocks.. .... 106 

source statement library books....... 106 

utilization 91 

maintenance of libraries 89,92 

maps ............28 

MCAR/CCH 123 

core image library blocks... •• 105 

MCH 34 

MERGE function (see library 
maintenance) 

merge library entries 92 

merge two libraries*. 92 

merge user programs 9 9 

MICR 35 



minimum machine requirements 30 

MBOTEs during supervisor assembly 32 

MODE ^'^ 

MODEL j6 

Imodelnumber suffix for CPU 36 

MRSLCH 4 6 

multitasking (AP) • 3 3 

N 

NPARTS 35 

NRES 52 

O 

OC 41 

OLTEP 41 

core image library blocks....* 105 

modules, number of 105 

phases, number of 105 

relocatable library blocks 105 

operational DOS/VS not available 81 

operational pack 

organization 71 

planning 26, 71 

operator-initiated communication 
(OC) 41 

organization of the system pack 72 

P 

page data set, define the 75 

page data set dump 

core image library blocks 105 

link-edit statements 132 

module name 132 

modules, number of 105 

phase names 132 

phases, number of 105 

page data set IPLing 101 

PAGEIN 35 

page pool, main 50 

parameters for 

ALLOC 4 9 

ALLOCR 50 

ASSGN 55 

CONFG 36 

DPD , . 57 

DVCGEN 53 

FOPT 38 

lOTAB 51 

PIOCS i. 46 

SEND 57 

STDJC 37 

SUPVR 33 

VSTAB 47 

partition save areas. 49 

PC 41 

FOIL 41 

PD 41 

PDAID 

core image library blocks 105 

phases 131 

phases, number of 105 

relocatable library blocks 105 

transients 131 

transients, number of 131 

PDZAP 132 

performance of FETCH and LOAD 27,40 
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PFIX 41 

PHO 35 

physical transient overlap '^^ 

PIOCS macro. "+6 

planning 

POWER/VS 25 

libraries (operational pack) 26,71 

supervisor 25 

system generation 25 

the emulators 25 

the page data set 2 5 

POWEE parameter in SUPVE 35 

POWER/VS 

computing the size of a supervisor, 

example , 70 

core image library blocks i05 

installation, documentation for 94 

macros 123 

POWEE parameter in SUPVE macro 35 

relocatable library blocks 105 

required and forced options with 

POWEE = YES. .., 59 

source statemeiit litrary blocks 105 

supervisor real storage requirements.. 63 
with RJE,SNA 33,51 

printer support, 
1403U/3203/3211/5203 (see IPL and 
buffer load) 

Printing Suosystem (3800) 

coding for // ASSGN 83 

device code for DVCGEN macro 61 

Dxxxx parameter for lOTAB macro 51 

SETPRT and QSETPRT macro 117 

support 117 

PRINTLOG Utility 130 

private libraries 85,90,97 

private second level directories 42 

PRMOD (printer module) ..-,.* Ill 

problem determination, 

IBM-supplied list for DOS/VS 26 

procedure library... ---....,..,, 2 5 

procedures 

bypass initialize disk 82 

delete 86 

Initialize disk bi <^5 

Xink-edit 86 

load the SVA 26 112 

processing the distribution tape... g^ 95 
restore distribution tape to ' 

disk 81,85,96 

system generation... 78 

processing the distribution tape 81,95 

programs for system generation and 
naintenance, examples of use 

backup 80,90,98 

CORGZ 80,90,99 

DSERV. 80,102 

FASTCOPy 8 0,90,102 

maintain system history 

(PTFHIST) 1 02, 1 06 

restore 80. 90, 96 

PRTY *i2 

PSERV 

core image library blocks 104 

link-edit statements. 119 

module names*. ...•..••.-.... ••- 119 

modules* number of.. 10 4 



PSLD HZ 

PTFHIST program, utilization of l,10z; 

PTO... 45 

Q 

QSETPRT macro 117 

QTAM 

core image library blocks..... 105 

modules, number of 105 

relocatable library blocks 1C5 

source statement library blocks ...... 1 C 3 

R 

RDE (ERRLOG) J 4 

real address area, size of , ^7 

real storage allocation for 

partitions. bO 

recorder file.. 7b 

reliability data extractor (RDE) » . 3 4 

RELLDR ^z 

relocatable library, IBM-supplied ^5 

relocatable library 

1403U printer buffer load 115 

3203 printer buffer load 115 

3211 printer buffer load Hb 

5203 printer buffer load 11^^ 

conrmon librarian modules 118.1 

CORGZ 104,118.1 

CSERV 10 4, 119 

DSERV 104,119 

DUMPGEN 105, 131 

ESERV 103 

EREP 103 

IPL 10 4, 115 

job control 10 4,118 

linkage editor 10 4,118 

LSERV 10 5,132 

MAINT 104,118.1 

PSERV 104,115 

RSERV 10U,11S 

SSERV 10 4,119 

Standard system dump 103,129 

translating system dump 10 3,129 

relocating load support 4 2,79 

replace identical library entries 9 2 

required macros 5S 

restore card to disk 

core image library blocks 10 6 

modules, number of 106 

phases, number of 106 

restore failure , , 35 

restore system tape to disk 81,85,95 

restore tape to disk or data cell 

core image library blocks 106 

modules, number of 106 

phases, number of 106 

restore utility 

core image library blocks.. 106 

examples of use 80,90,96 

modules, number of 106 

phases, number of... 1O6 

results of system generation 93 

RETAIN 4 2 

RMS 35 

RPS 42 
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RPS considerations 113 

deletion of RPS support 113 

preloading modules in the SVA 11"* 

RSERV 

core image library blocks 104 

link-edit statements 119 

modul e names •• 119 

modules « number of 104 

phase names 119 

phases, number of 10 4 

RSIZE ^7 

rules 

ASSGN 56 

DVCGEN 53 

supervisor generation macros.......... 33 

RUTAU <4t> 

S 

SDAIO 

transients 131 

link-edit statements 132 

module names 132 

modules, number of 105 

phase names. .•......«.......>.•.•.• •• 131 

SDL (system directory list)... 27 

SDL considerations. ••«.... 112 

search order for phases 27 

second level directory..... • 4.3 

BELCH 46 

selection of IBM- supplied 

supervisors 25,32,98 

BEND macro.. 57 

BET SDL 27 

6ETIME 40 

SETPRT macro 117 

shared virtual area (SVA)..... 47 

size calculation for libraries 73 

size of main page pool 50 

size of supervisors. .................... 120 

SKSEP 43 

SLD •• 43 

source statement library.... 25 

source statement library macros 

components of ••...••.. 103 

supervisor generation.. •..••.....•. •• 122 

system generation. - -. 33-59 

source statement library, 

IBM-supplied 25 

SP 37 

SPARM 38 

Specifications for the 3330* 3333, 

33U0, 334U, 3350 31 

specifications for the 3800 ?1,69 

SSERV 

core image library blocks... •.•....,•• 104 

link-edit statements...... 119 

module names .•.•...•.•..•.•..•••.•... 119 

modules, number of ...•....•••. 104 

phase names.. .................. ....•• 119 

phases, nximber of......... • 104 

SSLNS 53 

Standard label option 89,101 

standard system dump 

core image library blocks.... .•.••••. 103 

link-edit statements 129 

module names.* .... 129 

modules, number of..., 103 



phase names.. 129 

phases, number of............. io3 

status information on system 

libraries.. go 

STDJC macro ,,, 37 

storage requirements for 

IBM-supplied DOS/VS programs 72 

STXIT 40,115 

suffix for CPU model specification 36 

supervisor 

assemble 97 

catalog 32, 98 

compile 122 

computing the size of 70 

contents change 122 

core image library blocks 

(IBM-supplied) 103 

device code « 60 

display 98, 122 

example for computing the size 

of 71 

generation macros (basic).. 122 

identification 44 

macro documentation. 71,91 

phase name 12O 

phases, number of.... 105 

real storage requirements 62 

selection 26,32,98 

supervisor nucleus 12O 

supervisors, pre-conplled 26,120 

supervisor selection •••.. 26,32,98 

supervisor shipped by IBM 120 

suppressing the relocating loader 

function 42,79 

SUFVB 33 

SVA loading 112 

SVA load procedures 26,112 

SVA (shared virtual area) 4 7 

S¥M 38 

symbolic device name assiqnnent ,.. 56 

symbolic programmer units, maximum... 51,56 

SYNCH 43 

synchronous exit 43 

SYSFIL 43 

SYSnnn ^ 56 

SYSRES file 77 

system component sizes, DCS/VS. 102 

system configuration. 30 

system directory and library track 

capacities 75 

system directory list loading ,,.112 

system directory list (SDL) • 25 

system distribution 

disk users •• 77 

tape users 77 

system generation 78 

considerations • 89 

example, 93 

programs 80 

results 93 

Unsuccessful 102 

system generation and maintenance 

procedure • 78 

system libraries 25 

system libraries 

directory capacities 75 

track capacities. •• 75 

system updates, history of. 91,102 
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Bystem utility programs 

core image library blocks 106 

modules* number of.- 106 

phases, number of....-..--.- 106 



table requirements 

DTFCD 110 

DTFCN 112 

DTFDI Ill 

DTFPH 112 

DTFPR Ill 

DTFSR - . . , 112 

TAPE ^^ 

tape to data cell 

core image library blocks..-.-...,... 106 

ipodules, number of , 106 

phases, number of..-.. 106 

tape to disk 

core image library blocks-...* -|06 

modules, number of-.-. 106 

phases, number of....... 106 

tape ERP 131 

core image library blocks..... 105 

link-edit statements 131 

module names. * ....-- 131 

modules, number of-... 105 

phase names.... 131 

phases, number of. 105 

task timer support 44 

TEB (2495 error statistics) 43 

TEBV (tape error statistics by 
volume) 44 

teleprocessing (see BTAM, QTAM, 
and VTAM) 

time-of-day (TOD) clock support. 44 



TOD. 



44 



TOLTEP (see VTAM) 

TP 36 

track capacity of system library 75 , 85 

transients, IBM-supplied 

$$A$SUP1 124 

$$ ABERAA. • 124 

$ $ ABERAB 124 

$$ABERAC.. 124 

$$ABERAD 124 

$$AB£RAE 124 

$$ABERAF 124 

$$ABERAG 124 

$$ABERAH 124 

$$ABERAI 124 

$$ ABERAN 124 

$ SABER AO. 124 

SSABEEAP 124 

i$ABERAQ 124 

$ SABER AR 124 

$$ABERA1 124 

$$ABERA2 124 

$$ABERA3 , 124 

$$ABERA4 124 

$$ABERA5 124 

$$AB£RA6 124 

$$ABERA7 124 

$$ABERBA 124 

$$7^ERBC 124 

$$ABERBD .....< 124 



$$ ABERPl 124 

$$AEERP2 12U 

$$ABERP 3 124 

$$AEERP4 124 

$$AEERP5 124 

$$ABERP6 , 124 

$$ABERP7 124 

$$ABERP8 124 

$$AEERP9 124 

$$ABERRA 124 

$$AEERRB 124 

$$ABERRC 1 ^i. 

$$AEEBRD 124 

$$ABERRE 12a 

$$AEERRF 124 

$$ABERRG 124 

$$AEERRH 124 

$$ABERRI 12 4 

$$AEERRJ 124 

$$ABERRK 124 

$$AEERRL 124 

$$ABERRM 124 

$$AEERRN 124 

$$ABERRO 124 

$$A,EERRP 124 

$$ABERRQ 1 24 

$$AEEFRR 124 

$$ABERRS 124 

$$AEERRT 124 

$$ABERRU 124 

$$ABERRV 124 

$$ABERRW 124 

$$ABERRX 124 

$$ABERRV 124 

$$AEERRZ 124 

$$ABERR1 124 

$$ABERR2 1 24 

$$AEEFR3 124 

$$ABERR4 124 

$$AEERR5 124 

$$ABERR7 124 

$$AEERZ1 124 

$$ABERZ2 124 

$$BATTFO - 124 

$$EATTF1 124 

$$BATTF2 124 

$$BATTF3 124 

$$BATTF4 124 

$$BATTF5 124 

$$BATTNA 125 

$$BATTNB 125 

$$EATTNC 125 

$$BATTND 125 

$$BATTNE 125 

$$BATTNP 125 

$$BATTNG 125 

$$BATTNH 125 

$$BATTNQ - 125 

$$BATTNR 125 

$$BATTNS f 125 

$$BATTNT 125 

$$BATTNU 125 

$$BATTNV 125 

$$ BATTNW 125 

$$BATTNX 125 

$$BATTNY ••.- 125 

$$BATTNZ 125 

$$BATTN2 125 
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$$BATTN3 125 

$$BATTN5 125 

$$BATTN8 125 

$$BATTN9 125 

$ $ BATTUl 125 

$$BATTU2 125 

$$BCCPT1 125 

$$BCE0V1 125 

$ $ BCHKPD 125 

$$BCHKPE 125 

$$BCHKPF 125 

$$BCHKPG 125 

$$BCHKPT 125 

$$BCHKP2. 125 

$$BCHKP3 125 

$$BCHK3G 125 

$$BCISOA 1^5 

$ $ BCLOSE 125 

$$BCLOSP 125 

$$ BCL032 125 

$$BCLOS3 1^5 

$SBCL0S4 1^5 

$$BCLRPS 125 

$$BCMT01 1-^5 

$$BCMT02 1^5 

$$BCMT03 125 

$$BCMTOU 125 

$$BCMT05 125 

$$ECMT06 125 

$$BCMT07 125 

$$BCKT08 125 

$$BDMPBC, 125 

$$BDMPDC 125 

$$BDMPPD 125 

$$BDMPPT 125 

$$BDMPVA 125 

$$BDRSTR 125 

$$BDUMP 125 

$$BDUMPB,.. , 125 

$$BDUMPD 125 

$$EENDFI 125 

$$BENDFL 125 

$$BEOJ 1^5 

$$BE0J1 125 

$$BE0J2 125 

$$BE0J2A 1^5 

$$BE0J3 125 

$$BE0J3A 125 

$$BEOJU 1^5 

$$BE0J5 125 

$$BE0J7 126 

$$BERRTN 126 

$$EFCB . 126 

$$BFCBOO 126 

$$BFCB3 126 

$$EFCB5 126 

$$BILSVC 126 

$$EIi^iDEX 1 26 

$$BJCOPT 126 

$$BJC0P1 126 

$$BJDUMP 126 

$$BLSTIO. 126 

$$ELVTOC 126 

$$BMSGWR 126 

$$BMSGW1 126 

$$BMVKEX 126 

$$E0CPM1 126 

$$B0CPM2 126 

$$BCCPRP 126 



$$B0CPT1 126 

$$ECCPT2 . 1 ^6 

$$B0CPT3 126 

$$BOCPTa 1 26 

$$ECCP01 126 

$$BOCP02 126 

$$ECCP03 126 

$$B0CP11 126 

$$ECCP12 1 26 

$$BOCRTA 126 

$$EOCRTB 126 

$$BOCRTC 126 

$$EOCRTD 126 

$$BOCf E. 126 

$$BOCRTF 126 

$$EOCRTG 1 26 

$$BOCRTH 126 

$$EOCRTK 126 

$$BOCRTL 126 

$$EOCRTM 126 

$$BOCRTN 126 

$$BOCRTO 126 

$$BOCRTP 126 

$$BOCRTQ 126 

$$BOCRTR 126 

$ $ BOCRTS ^ 126 

$$BOCRTT 126 

$ $ BOCRTU ,, 126 

$$BOCRTV 126 

$$BOCRTW 1^6 

$$BOCRTX 126 

$$BOCRTY , 126 

$$BOCRTZ 126 

$$BOCRTl 126 

$$BOCRT2 126 

$$BOCRT3 126 

$$B0CRT4 126 

$$BOCRT5 126 

$ $ BOCRT6 126 

$$BODACL , 126 

$$BCiJAIM 126 

$$BODAIN 126 

$$B0DAI1 126 

$$BODAOl 127 

$ $ B0DA02 127 

$ $ B0DA03 , 127 

$$BODAO'» 127 

$$BODARP 127 

$$BODARS 127 

$$BODAUl 127 

$$BODIOl 127 

$$B0DI02 127 

$$BODI03 127 

$$B0DI04 127 

$$BODI05 127 

$$B0DI06 127 

$$B0DI07 127 

$$BODI08 127 

$$BODMSG 127 

$4boDMS2 127 

$ $ BODQ UE 127 

$$BODSMO 127 

$$B0DSMW 127 

$$BODSPO, 127 

$$BODSPV 127 

$$ BODSPW 127 

$ $;B0DUCP 127 

$$BOFLP'i;.... 127 

$$BOISRP 127 
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$$BOIS0I 12 7 

$$BOIS02 127 

$$BOIS03 ,. 127 

$$BOIS0t 127 

$$BOIS05 127 

$$BOIS06 127 

$$EOIS07 , 127 

$$BOIS08 127 

$$BOIS09 *... 127 

$$BOIS10 127 

$$B0IS11 1 27 

$$BOMRCE 127 

$$B0MSG1 127 

$$B0MSG2 127 

$$B0MSG3 , 127 

$$B0MSG4 127 

$$B0MSG5 127 

$&£0MSG6 127 

$$B0MSG7 127 

$$B0MSG8 127 

$$BOMT0M 127 

$$BOMT0W 127 

$$BOMT01 127 

$$BOM102 127 

$$BOMT03 127 

$$BOMT0U 127 

$$BOMT05 127 

$$BOMT06 127 

$$BOMT07 127 

$$BONVOL "127 

$$BOPEN 127 

$$BOPENC 1 27 

$$BOPEND 127 

$$BOPENB 127 

$$BOPENS 1 27 

$$BOPEN0 127 

$$B0PEN1 127 

$$B0PEN2 127 

$$B0PEN3 1 27 

$$BOPENa 127 

$$BOPIGN 127 

$$BOPNLB 127 

$$B0PNR2 127 

$$B0PNF3 127 

I $$B0PR3 127 

3$B0RTV1 127 

$$B0RTV2 128 

$$B0SDB1 128 

$$BCSDC1 128 

$$BOSDC2 128 

$$B0SDC3 128 

$$BOSDEV 128 

$$B0SDI1 128 

$$B0SDI2 128 

$$B0SDI3 128 

$$B0SDI4 128 

$$B0SDI5 128 

$$BOSDOl 128 

$ $ B0SD02 128 

$$BOSD03 128 

$$BOSDOU 128 

$$B0SD05. 128 

$$B0SD06 128 

$$BOSD07 128 

$$B0SD06 128 

$$B0SD09 128 

$$BOSDRP 128 

iSaoSDBK 128 



$$BOSDRS 

$$B0SDW1 

$$BOSDW2 

$$B0SDW3 

$$BOSD00 

$$BOSD01 

$$BOSD02 

$$BOSD03 

$$BOSIGN 

$$BOUR01 

$$BOVDMP 

$$BOWDMP 

$$B02321 

$$BPCHK 

I $ $BPCLOS 

$$BPDAID. 

$$BPDMPC 

SSBPDUMP 

$$BPDMPC 

$$BPSW 

$$BRELSE 

$$BRMSG1 

$$BRMSG2 .- 

$$BRSTRB 

$$BRSTRT 

$$BRSTR2 

$$BRSTR3 

$$BRSTRU 

$$BSDRUP 

$$BSETFF 

$$BSETFG 

$$BSETFH 

$$BSETFI 

$$BSETFL 

$$BSETL 

$$BSETL1 , . . 

$$BSETL2 

$$BSYSWR 

$$BTERM 

$$bucboo 

$$BUCB 

$$BUCB3 

$$BUCB5 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

$$BVSDMP 

$$B3540I 

$$B35aOO 

$$B35400 

$$RASTOO 

$$RAST01 

$$RAS'r02 

$$RAST03 

$$RASTOa 

$$RAST05 

iiRAsioe 

$$RAST07 

$$RAST08 

$$RAST09 

$$RAST10 

$$RASTX1 

$$RAS112 

$$RAST13 

$$VOPENT 

transients, required - I2a- 
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translating syston dump 

core image library blocks 103 

link-edit statements 129 

modules, number of •••...••.... 129 

phase names 129 

phases, number of ••••• 103 

TRKHLD 44 

TSWTCH 46 

TTIME 44 

TTIMER 45 



U 



UNIT 

USERID 

Utilities* system (see system 
utility programs) 



57 
44 



virtual address area • 47 

virtual partition save areas 49 

virttjal storage access method 

/VSAM) support 45 

VOLID 57 

volvime serial number* .*•••••.« •.« 89 

VSAM 45 

core image library blocks/phases 106 

macros, number of 106 

modules, ntunber of..*. 106 

phases, number of • .•••.. 106 

relocatable library blocks.. 106 

source statement library blocks. ..••. 106 

transients, number of...... 106 

VSAMSVA 26 

VSIZE. . 47 

VSTAB macro 47 



VTAM 

core image library blocks 106 

macros, number of - 106 

modules, number of 106 

phases, number of 106 

relocatabl e 1 ibrary blocks 106 

source statement library blocks 106 

VTOC display 

core image library blocks «... 106 

modules, number of 106 

phases, number of.. 106 

transients, number of 106 

W 

UAIIM 45 

work files 

assenbler 118 

linkage editor 118 

X 

XECB 45 

XREF 38 

XTBIxxxx phases 117 



Z 
ZONE. 



45 
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Introduction 



The object of DOS/VS system generation is to tailor the IBM-supplied system to tne 
requirements of your installation. This tailoring process is accomplished by: 

1. Planning system generation 

2. Implementing the plan by performing a system generation 

3. Testing the results by running the applicable IVP (Installation Verification 
Procedure) and sample problems. 

Detailed planning is essential to efficient system generation. It minimizes the need to 
modify the system after it is generated. You may want to contact your IBiyi marketing 
representative to set up a system generation planning meeting. IBM field engineering 
would also attend the meeting to discuss the procedure to install the SCP (Systems 
Control Programming). Planning a system includes: 

• Evaluating which of the IBM-supplied supervisors most closely meets your 
installation's requirements. Considering modifications, such as deleting components 
from, or adding options to the selected supervisor (s) . Estimating the size of the 
planned supervisor and assessing tne effects of some of the major options, such as 
multiprogramming and POWER/VS,, on the operation of your system. 

• Tailoring the supervisor to the needs of your installation, which includes planning 
the options and estimating the size of the supervisor. This entails assessing the 
implications and effects of some of the major supervisor options, such as 
multiprogramming and POWER/VS,, on the operation of ycwr system. 

• Planning the contents, organization, and size of the system and private libraries. 

• Generating POWER/VS (optional). 

• Planning the Page Data set. 

• Emulator generation (optional) . 

These major planning considerations are described in detail in the DOS/VS System 
Management Guide .. 

IBM supplies DOS/VS on either magnetic tape or on disk. These distributions are 
discussed under "Distribution of DOS/VS". 

DOS/VS is shipped in four libraries: 

The source statement library contains macro definitions in edited format. After the 
desired parameters have been chosen, the macros can be assembled. Any A- library macros 
carried over from previous releases must be edited before they can be used for assembly. 

The relocatable library contains IBM programs that have not been assigned addresses 
for execution and assembled macros from the source statement library. These assembled 
macros perform input and output procedures for IBM-supplied programs. They constitute 
Logical IOCS modules that can also be used by problem programs, whenever applicable. 

The core image library contains programs that are ready for execution. System control 
programs and system service programs are always shipped in the core image library. An 
assembler program is also provided for system generation and maintenance. The system 
control programs must always be part of the system. The librarian programs are a key set 
to the system and should be carefully considered before ever removing them from the 
system. 
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The procedure library is designed to contain frequently used sets of job control and 
linkage editor control statements, as well as control statements for IBM-supplied service 
prograiDS. The procedure library as it is shipped on the distribution mediun contains the 
SVA load procedures SDL, EPS, VSAMSV.A, and VSAMEPS. The purpose and contents of SDL and 
EPS are discussed under "SDL Considerations" and "EPS Considerations", respectively; for 
the purpose and contents of VSAHSVA and VSAMEPS, refer to "Module 17: VSAM", The 
procedure library also contains procedures for linking and deleting DOS/VS cornpooeDts. 

During system generation, you work with the IBM- supplied system, tailoring it to your 
individual needs by adding to and deleting from the IBM-supplied and your own private 
libraries (source statement, relocatable, and core image) . Please note that the 
procedure library can only be a system library; the system does not support private 
procedure libraries. 



PLANNING SUMMARY 

The following considerations and decisions should be made before system generation, refer 
also to Figure 1-1: 

• Determine if one of the IBM-supplied supervisors fits your needs. The supervisors are 
pre-compiled and can therefore save you the lengthy process of defining, assembling, 
and link-editing. More information on these supervisors is given under "Supervisor 
Nucleus", for details refer to the "Memorandum to Users". 

• Select supervisor options by coding a set of supervisor macro instructions (see 
"Chapter 3: Planning the System" in DOS/VS System Ma nagement Guide ) . 

• Determine the programs that are to be in the core image and relocatable libraries of 
each operational pack. 

• Utilize the serviceability aids recommended in DOS/VS Serviceability Aids and 
Debugging Procedures , GC33-5380, during system generation, by including applicable 
aids from the following list in your DOS/VS system (section nximbers refer to sections 
in that manual) : 

Recovery Management Support (including Tape and Disk Error by Volume 
Statistics — Section 2-F) 

Fetch/Load, I/O, GSVC and QTAM traces, and the Transient Dump (Problem 
Determination Serviceability Aids, PDAIDS — Section 2-B) 

- DUMPGEN (DOS/VS Standalone DUMP Generator, with fornatting DUMP 
option — Section 2-A) 

DOSVSDMP (COS/VS high-speed Standalone dump program for both formatted and 
unformatted dump output — Section 2-A) 

LVTOC and the Library Display Program (including the Access Method Services 
Utility Aids — Section 2-C) 

Online Terminal Test (Teleprocessing Aids — Section 2-F) 

LSERV (Label Cylinder Display Program — Section 2-C) 

SDAIDS (System Debugging Aids — Section 2-B) 

• If the system supports private core image libraries (PCIL=YES specified in the FOPT 
macro) , determine which programs are to be placed in the private core image library or 
libraries. Under such a system, the linkage editor executes in any partition. You 
can link-edit most IBM-supplied programs for execution in a foreground partition and 
place them in a private core image library assigned to that partition if enough core 
storage is available to execute the link-edited program. If desired, the version to 
execute in the background partition may be retained in the system core image library. 
It is not necessary to have different versions of a particular program for execution 
in different partitions, if the supervisor is generated to include the relocating 
loader. 
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You must place the supervisor (default name $$A$SUP1) in the system core image 
library. A supervisor cataloged to a private core image library cannot be used. 

The normal search order for loading phases into storage is as follows: 

• If the requested phase is a $$R phase (HCAE/CCH transient) , the system searches only 
the system core image directory. 

• If the requested phase is a $$A or $$B phase (transient) , the system first searches 
the system core image directory, then, if necessary, it searches the private core 
image directory assigned to the partition. 

For an attention routine command that results in a phase being loaded into virtual 
storage, DOS/YS searches only the system core image directory. Therefore, phases such 
buffer-image phases for an FCB or a DCB must be cataloged in the system core image 
library and not in a private core image library. 

If the phase is not found, the system enters the wait state with an error message of 
X»00000FF4» in bytes through 3 of low storage. 

When you request other phases, the system searches both the system and private 
directories, if necessary. If the phase name starts with $, the system first searches 
the system core image directory and, if it does not find the phase, it then searches 
the directory of the private core image library, assigned to the partition. If the 
requested phase name does not begin with a $, the system first searches the private 
core image directory, then the system core image directory, unless SYS=YES is 
specified in the FETCH or LOAEr macro, in which case the system directory is always 
searched first. 

To improve the performance of FETCH and LOAD in a multiprogramming system you can 
build an SDL (System Directory List) , containing the names of, and additional 
fetch/load information on, frequently used transients and phases. The SDL, however, 
is not searched for phases that are loaded by attention routines. The list is built 
as a result of the SET SDL=CREATE command and subsequent data statements. These 
statements can also be provided through an IBM-supplied cataloged procedure. 

Determine which modules are to be deleted from the relocatable library of each 
operational pack. Deleting from the relocatable library allows for expansion of the 
system core image library to hold a greater number of components. Refer to the 
relevant book module for each component for its sizes. 

Also determine if the macro definitions used to build the supervisor and IOCS modules 
are to be deleted from the source statement library. Retaining the macros in the 
source statement library facilitates building a new supervisor and new IOCS modules. 

With only one disk drive available you may prefer to maintain only enough room in the 
relocatable library of the operational pack to contain the modules for building the 
largest component in the system. This small relocatable library permits temporary 
insertion of any component in relocatable form. It can then be immediately 
link- edited into the system core image library and then deleted from the relocatable 
library. When the relocatable library is subsequently condensed, only the updated 
core image form of the component remains, thus conserving disk-storage capacity. 
Reducing the size of the relocatable library allows expansion of the system core image 
library. The expanded system core image library allows a greater number of programs 
to be online with a single system volume. 

Copy and restore programs are necessary to transfer the resident system from tape to 
disk, from disk to tape, from disk to cards, and from cards to disk for maintenance 
and backup purposes. 
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The procedures for the system configurations presented in this publication assune that 
the disk packs have been initialized with the VTOC on the cylinder shown below: 



Eevice used 


1 VTOC 


on 


Cylinder 












1 For System 


Packs 


1 For Work Packs 


2314/2319 


1 199 






1 or 199 


3330 Model 1 or 2 


1 403 






1 or 403 


3330 Model 11 


1 807 






1 or 807 


3340 (3348/35MB) 


1 347 






1 or 347 


3340 (3348/70MB) 


1 695 






1 or 695 


3350 


1 554 






1 or 554 



MAPS AND LISTINGS PRODUCED DURING SYSTEM GENERATI ON 

All linkage editor output on SYSLST from the Si'Stem generation procedure and any future 
updates (including maps produced by the linkage editor) must be retained. These maps 
provide necessary information on the level of the system and the load address 
(relocation) of each component. Similarly, all assembly listings produced during system 
generation, in particular supervisor and POWER/VS listings, should be retained. These 
maps and listings can be used by the systems programmer and the customer engineer 
maintaining the system. 
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Q 



(Siflttflflnniafl \ 
Decide on the number j 
of system disks ^ 



Rej>!an_ 

Modify the desired 
system to fit into 
available space 




OBti_qrB 

1. Select options 

2. Calculate 
real storage 
space 



Private Core 
lrnaae.ybraryJl 
1 . Select programs 

to reside in 

this library 
\ 2. Calculate 

library size 



System Core 
trna9e.Library_ 
1. Select programs 
to reside in core , 
image library 
\ 2. Calculate 
library size 




6 



' During a search operation, private 
libr*ries are searched BEFORE 
system libraries, except when 
tearching core image libraries for 
phase names beginning with $. 



Private Relocatable 

Library* 

1 . Select programs 

to reside in 

this library 
\2. Calculate 

library size 



System Procedure 

Library. 

1. Select procedures/ 
to reside 
in this library 
^2. Calculate 
library size 



System Relocatable 

Librarij 

1 . Select programs 

to reside in 

this library 
\2. Calculate 

library size 




Private Source 
Statement_Librar^ 

1. Select books to 
reside in 
this library 

2. Calculate 
library size 



System Source 
StatementJJbraiY 
1. Select books 

to reside in 

this library 
I 2. Calculate 

library size 








Figure 1-1. INTRODUCTION — Planning Suirmary 
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System C<mfigiiration 

This section presents the minimum system configuration required to operate DOS/VS. The 
system control programs and basic IOCS must always be present to execute any other 
programs. In view of the many different possibilities of attaching I/O units to the CPU 
models supported, the minimum machine requirements for the Model 115 CPU and the Model 
125 CPU are listed separately. The requirements for the CPU Models 135, 138, 145, 148, 
155-11, and 158 are listed together. 

MINIMUM MACHINE REQUIREMENTS - MODEL 115 

A System/370 CPU Model 115. 

Standard instruction set (See Note 1) . 

One Card Reader: mU2**, 2501+*, 2520**, 2540+*, 2560*, 2596+*, 3505**, 3525**, 

or 5U25* (See Note 2 and 3). 
One Card Punch : 1442**, 2520**, 2540**, 2560*, 2596**, 3525*+, or 5425+ 

(see Note 2 and 3) , 
One Printer : 1403**, 1443**, 3203* (Model 1 or 2), or 5203* (with or without UCS) 

(see Note 2). 

One Integrated Display Operator Console, optionally with a 5213 Console Printer attached. 
One 3340* Model A2 Disk Storage. 

* These devices are natively attachable to the Model 115. 

** These devices must be attached to the Model 115 via a multiplexer channel. 

Notes ; 

1. Language translators may require extended instruction sets. 

2. One 7- or 9-track 3410-3411 or 3420 (Model 3 or 5) series magnetic tape unit, or a 
disk extent may be substituted for this device. If a 7-track tape unit is used, the 
data conversion feature is required, except when the unit is substituted for a 
printer. 

3. The IBM 3540 Diskette I/O Unit may substitute for this device. In a cardless system, 
at least one 3741 or 3742 data entry unit is required to have a record insert feature 
to support program maintenance requirements. 

MINIMUM MACHINE REQUIREMENTS - MODEL 125 

A System/370 CPU Model 125. 

Standard instruction set (see Note 1) . 

One Card Reader: 1442**, 2501**, 2520+*, 2540**, 2560*, 3504*, 3505**, 3525*, or 5425+ 

(see Note 2 and 3) . 
One Card Punch : 1442**, 2520**, 2540**,, 2560*, 3525*, or 5425* (see Note 2). 
One Printer : 1403*, 1443**, or 3203* (Model 1 or 2) (see Note 2). 

* These devices are natively attached. Attachment of Card Reader/Punch devices is as 
follows, either 

One 350 4, or 

One 3504 and one 2560, or 

One 3504 and one 3525, or 

One 2560, or 

One 3525, or 

One 3504 and one 5425, or 

One 5425. 

** This device may either be natively attached, or be attached to a multiplexer channel. 

One Model 125 Integrated Display Operator Console, optionally with a 5213 Console Printer 

attached. 

One 3333 Model 1 Disk Storage, natively attached (two disk storage devices) , or 

One 3340 Model A2 Disk Storage. 
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Notes : 



1. Language translators may require extended instruction sets. 

2. One 7- or 9-track 3410- 3411 or 3U20 (Model 3 or 5) series magnetic tape unit, or a 
disk extent may be substituted for this device. If a 7-track tape unit is used, the 
data conversion feature is required, except when substituted for a printer. 

3. The IBM 3540 Diskette I/O Unit may substitute for this device. In a cardless system, 
at least one 3741 or 3742 data entry unit is required to have a record insert feature 
to support program maintenance requirements. 



HIMIMUM HACHIME BEOOIBEMEMTS - HODEL 135. 138, 1»5. H8. 155-11, Qg 158 

A Syst©»/370 CPU Hodel 135> 138, 145, 1«8, 155-11, or 158, 

Standard instruction set (see Note 1> . 

One Card Reader: 1442, 2501, 2520, 2540, or 3505 (see Note 2). 

One Card Punch: 1442, 2520, 2540, or 3525 (see Note 2). 

One Printer: 1403, 1443, 3211 (see Note 2), 3203-4 (for Models 138 and 148 only), or 3800 

One 3210/3215 Console Printer Keyboard, attached to the ■ultiplexar channel, or 
One 3277 Operator Console for the Hodel 138 and 148. 

One 2314* Direct Access Storage Facility, or 

One 2319 Direct Access Storage Facility^ natively attached or 

One 3333 Disk Storage, Model 1, attached either natively or through a 3830-2 Storage 
Control Unit (see Note 3), or 

One 3330 Disk Storage, Hodel 1, 2*, or 11, attached through a 3830-1 Storage Control 
Unit (see Note 3 and 4) , or 

One 3340 Disk Storage, Model A2, attached through (see Note 4): 

a. the IFA (Integrated File Adapter) on the Systera/370 Model 135, or 

b. the ISC (Integrated Storage Control) on the System/370 Model 14 5, or 

c. the 3830-2 Storage Control Unit on the System/370 Models 135 and 145, or 

One 3350 Direct Access Storage, attached through: 

a. the 3830-2 on the SysteB/370 Hodel 135 and higher, or 

b. the ISC (Integrated Storage Control) on the SY8tee/370 Hodel 145 and higher. 

* The ainieua DOS/TS configuration requires two DASD spindles, one of vhlch sust be with 
reaovable pack, or one DASD spindle and teo eagnetic tape drives. If the tape units 
are 7-track, the data conversion feature is required. 

Notes ; 

1. Language translators may require extended instruction sets. 

2. One 7- or 9- track 2400 or 3400 series magnetic tape unit, or a disk extent may be 
substituted for this device. If a 7-track tape unit is used, the data conversion 
feature is required, except when substituted for a printer. Neither the tape unit 
nor th« disk extent can be substituted for the card reader as the communication 
device during system IPL time. 
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3. The 3333 Disk Storage (unless natively attached) and the 3330 Disk Storage* Hodel 1« 
2, or 11, require a high-speed selector channel. 

4. Requirements and specifications relating to the 3330 apply also to the 3333 and 3350 
in compatibility mode of the 3330-1. Those given for the 3340 apply also to the 

33UU. 



MNOTES DURING SUPERVISOR ASSEMBLY 



During supervisor assembly* the assembler may generate MNOTEs- You may choose to ignore 
some by accepting the assumed values given in the MNOTEs. For others,, you may have to 
interrupt procedures* modify one or more specifications and reassemble the supervisor. 

Some general procedures for resolving MNOTEs are: 

1. Go to the DIAGNOSTICS section at the end of the supervisor assembly listing; it 
includes references to the MNOTEs generated during assembly. Each MNOTE reference is 
in the form 

statement-number IPK216 MNOTE GENERATED 

2. Using the statement number, go back into the listing and exounine each of the MNOTEs. 
A severity code precedes the message portion (the higher the code, the more severe 
the error). Each MNOTE is listed after the macro with which it is associated. 

3. Determine the reason for the MNOTE. The MNOTE message indicates the parameter in 
question and usually provides a clue to the type of discrepancy. Same errors to look 
for are: 

• Misspelled items or mispunched numbers. 

• Parameters that are incompatible with other parameters in this or another macro. 

• Parameters that are outside the valid limits- 

U, Make any necessary changes and reassemble. If you have no changes to make (in other 
words, the assumed values listed in the MNOTEs are acceptable), continue with the 
generation procedures. Some errors are so severe, however, that no object deck is 
generated, and you roust correct one or more macros and reassemble before continuing. 

CATALOGING THE SUPERVISOR 

The Supervisor Select function enables you to select different tailored supervisors,, 
cataloged in the core image library of your operational pack. Cataloging these 
supervisors can either be accomplished by specifying the ID parameter in the SUPVR macro, 
which only changes the last character of the supervisor name, or by changing the PHASE 
statement punched during supervisor assemblies, in which case you are free to select your 
own 8-character supervisor name. It is recommended to name the most frequently used 
supervisor $$A$SUPlrf since it is the default of the Supervisor Select function. During 
multiprogramming, the supervisor $$A$SUP1 cannot be cataloged. 

Tott can select the desired supervisor during IPL tiae by 

pressing the LOAD key on the CPD panel; when the systes enters the wait 8tate» press 
the REQUEST/ENTER key on the console. Vhen sessage 0103 A SPECIFY SOPESTISOS HAHE is 
displayed* type in the nase of the desired supervisor fi£ press the EMD or EVTER key to 
select the default SSASSUPI. 

Example ; 

Specify ID=x in the SUPVR macro 

Catalog the supervisor. When performing the IPL procedure, specify $$A$SUPx. 
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The Supervisor Generation Macros 

This section defines the macros and their parameters required to generate an 
installation-tailored supervisor for DOS/VS. 

Note that the supervisor must be assembled with ALIGN=YES (assumed default value) in 
the STDJC macro instruction, because ALIGN=NO causes performance degradation and may 
result in assembly errors. 

RULES FOR USING SUPERVISOR GENERATION MACROS 

1. The assumed value default for an omitted parameter is underlined in the following 
discussion. Wherever an alternate default is possible, both operands are underlined. 

2. Braces {} indicate that you must select one of the enclosed values. 

3. Bracketed operands are optional, for example, [nj . 

4. Replace the letter n in a parameter with a decimal number. 

5. The name field must be blank- The operation field always contains the mnemonic 
operation code. The operand field contains the parameters. 

6. For any given macro, several parameters may be contained on one line. Separate each 
parameter with a comma. No embedded blanks are permitted. Continuation cards are 
permitted (nonblank character in column 72; the continue column is column 16). 

7. In the expression X'cuu', replace cuu with the hexadecimal number for channel and 

unit.. 

8. The macros must be issued in the following sequence: SUPVR, CONFG, STDJC, FOPT, 
PIOCS., VSTAB, ALLOC, ALLOCR, lOTAB, DVCGEN, ASSGN, DPD, SEND. 

9. The DVCGEN, ASSGN, ALLOC, ALLOCR, and DPD macros are not required. They are 
specified if input/output tables (DVCGEN) are being specified, if standard 
assignments (ASSGN) are being made, if storage is allocated (ALLOC and ALLOCR), or if 
the page data set (DPD) is defined at system generation time. 

10. An END statement and a /* statement must follow the SEND macro instruction, 

11. Figure 1-U shows the device type codes of the DOS/VS supported devices used for 
system generation, 

SUPVR 

The (SOPVR) Supervisor macro and its parameters define the system as disk resident with 
the ability to support certain desired functions, such as multiprogramming, HICR, or 
teleprocessing , 

PARAMETERS FOR SUPVR 

( no) Specify if multitasking support is desired. Multitasking allows 
AP=lYEs/ the execution of more than one program within a partition. 

Specification of AP=YES is required if TP=VTAM is specified and 
also if you want to use the ATTACH, DETACH, ENQ, and DEQ macros for 
your programs. AP=YES must be specified if support for POHEE/VS 
with EJE,SNA is required. 

WAITM=YES is forced by AP=yES. An invalid specification of AP 
causes YES to be forced. If AP=YES is specified and NPAETS is 
omitted or specified as 1, !IPAETS=3 is forced. 
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/ no) Specify if supervisor support of ASCII/EBCDIC translation tables 
ASCII=(YEs/ is desired. ASCII=YES must be specified if support of ASCII tapes 
by magnetic tape IOCS is required. 



/ no) a specification of CHAN=YES is required if multiplexer 
CHAN=(YES) channel-attached devices, tape units, or teleprocessing devices 



(Models 115 
nd 125 only) 



are present on your Model 115 or 125 CPU- Software recording is 
performed for channel-attached devices and for tape units only. If 
these devices are part of the system, a check is made during IPL to 
see if RMS error recording support is provided; if it is not, the 
system enters a hard wait state. RMS=YES overrides a specification 
of CHAN; it should be specified if full error recovery is required 
in addition to error recording. For detail information, refer to 
PS£Z2S Sg£v4ce^424t£ ^ids and De^uasing S^ocedurgs. 



^RDE) Specify to include RDE (Reliability Data Extractor) recording in 
ERRL0G=( YES f addition to normal RMS error recording. RDE causes recording of 

"End of Day" via the ROD operator comimand and of the cause of IPL. 
This provides additional data for installation and IBM evaluation 
of system performance. The RDE option does not require any 
additional real storage. 

If RDE recording is desired for a Model 115 or 125 CPU, normal RMS 
error recording support must be generated by specifying CHAN=YES or 
RMS=YES. 

Note : For reasons of compatibility with earlier DOS releases, 
ERRLOG=(YES,RDE) may Still be specified. Specification of 
ERRLOG=YES has no effect since error recording is controlled by the 
MODEL- parameter or, for a Model 115 or 125, by CHAN= and RMS=. 
Specifying ERRLOG=( YES,RDE) is identical to specifying ERRLOG=RDE. 

i no) Specify EU=YES if you require mixed parity tape processing for the 
EU=(YES/ 14xx emulators and the tape preprocessor and tape postprocessor 
programs. EU=YES need not be specified to run these programs if 
mixed parity tape processing is not required. 

Note : For reasons of compatibility with earlier DOS releases, 
specification of EU=RELOC is accepted by the assembler as if EU=YES 
had been specified. 



ID=tc/ 



Specify this parameter if you plan to use the Supervisor Select 
option. You can assign a unique name to the supervisor being 
generated fay specifying any alphameric character (A-Z,l-9) in this 
field. For example, if you specify ID=A, then the supervisor will 
be named $$A$SUPA when it is placed on the core imiage library. If 
this parameter is omitted the supervisor will be named $$A$SUP1. 



MCH 
(Models 115 
or 125 only) 



/yes) 

=V no/ 



This is an option for CPU Models 115 and 125 only. Do not specify 
this parameter for CPU Models 135 and up. For these models, 
support for the Machine Check Analysis Recorder (MCAE) and Channel 
Check Handler (CCH) features is standard. 

MCH=YES in conjunction with CHAN=YES is equivalent to specifying 
EMS=yES. In addition to the software recording services generated 
by specifying CHAN=YES, specification of MCH=yES generates the 
error recovery (HCAR and CCH) portion of EMS. 
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MICR=< 1 



\ 1419> 



Specify if the supervisor is to support magnetic ink character 
readers or optical reader/sorters. If 1255/1259/1270/1275s are 
to be supported, indicate 1U19. 1419D indicates Dual Address 
Adapter 1419/1275s only; 1419 support does not provide 1419D 
support. If 1419s or 1255/1270/1275s are attached to a multiplexer 
channel, BMPX=YES should be specified in the PIOCS macro. However, 
burst mode and MICR devices cannot run concurrently on the same 
byte-multiplexer channel - A warning MNOTE to that effect is 
issued. Please note that 3 886 Optical Character Readers do not 
require MICR support. 



NPARTS=<3 



Specify the number of partitions to be supported. The maximum 
value of n is 5. For reasons of compatibility with earlier DOS 
releases, MPS=YES, NO, or BJF is also accepted by the assemJ^ler. 



The default tak e n is 1 if : 

The AP, MPS, POWER, and TP parameters are either not specified, or 
specified as NO. 

The default taken is 3 if any of the following is specified ; 

AP=YES 
MPS=YES 
POWER=YES 
TP=QTAM 



If NPARTS is omitted or is specified as 1, specification of any of 
these parameters forces NPARTS=3. 



PAGEI 



(no) Specify that paging activity i 
N=\ nf RELPAG, and FCEPGOUT macros. 



s to be controlled by the PAGEIN, 



(See DOS/VS Supervisor and I/O Macros , for a complete description 
of these macros.) 



PHO^ 



( m\ 

1=1 YES) 



POWER 



=\YESf 



The value n indicates the maximum; number of page- in requests that 
can be queued at any one time for execution. Each PAGEIN macro 
issued in a program represents a page-in request. To obtain 
support for the three macros, the values specified for n must be 1 
or larger. 

Specify if page exception handling overlap (PHO) is desired. 
PHO=YES allows control to be passed to a user routine while a page 
fault is being handled. Specification of PHO=YES is required if 
you want to use the SETPFA macro in your programs. (For more 
details see the DOS/VS System M an a gement Guide . ) When PHO=YES is 
specified, PFIX=YES is forced. PHO=YES is forced if POWER=YES is 
specified* 

Specify if support for POWER/VS is desired. If POWER=YES is 
specified, the following options are forced: PHO=YES and NPARTS=3 
(if NPARTS was not specified or if NPARTS=1 was specified) in the 
SUPVR macro, PFIX=YES and ECPREAL=YES in the FOPT macro. 



i no) Specifying RMS=YES is equivalent to specifying both CHAN=YES and 
RMS='lYESf MCH=YES. RMS=YES overrides any specification of CHAN and/or MCH. 
(Models 115 If RMS=NO is specified, or if the parameter is omitted, the 
and 125 only) generation of RMS support is governed by specifying the CHAN and/or 

MCH parameters. RMS=YES is required if the string switch feature 
is installed. EMS=YES should be specified if a multiple partition 
system is used, EMS=YES is forced if TP=VTAM. 
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N0\ Specify if teleprocessing is desired and, if so, whether Basic 
VTAmI (BTAM) , Queued (CTAM), or Virtual (VTAM) Access Method is desired. 
TP= I BTAM[, VTAM} > When QTAM is Specified, support for BTAM is also included. If ETAM 
QTAM[,VTAM]\ runs in virtual mode, PFIX=YES is required- For QTAMn, n is the 
[QTAMn [,VTAM] ) maxiitiuir number of message processing programs in the system at any 
one time. n may have any value from 2 to 12. If VTAM is specified 
and also for multitasking, AP=YES must be specified. If AP=NO and 
QTAMn are specified, n is forced to 2. If TP=QTAM or TP=VTAM and 
NPARTS=1 or is omitted, NPARTS=3 is forced. 

If both BTAM and VTAM, or both QTAM (or QTAMn) and VTAM are 
specified, the operands must be placed between parentheses, for 
example, TP= (BTAM, VTAM) . 

Specification of VTAM forces AB=YES, ECPREAL=YES, GETVIS=YES, 
IT=YES, OC=YES, PC=YES, PFIX=YES, RELLDR=YES, TOD=YES, WAITM=YES, 
and RMS=YES in the case of Models 115 and 125 in the FOPT macro. 

If POWEE=yES is specified and your version of POWEE/VS is to 
support EJE,SNA, TP=VTAM must be specified. 



CONFG 



The CONFG (Configuration) macro instruction and its parameters define the system 
configuration and can specify generation of optional supervisor services. 

PARAMETE RS FOR CONFG 

i no) Specify only if your CPU has the floating-point feature. 
FP=iYES/ 

HODEL=iaodelttumb«r[ -suffix ] 

Specify the model number of the CPU and the suffix if applicable. 
Omission of this parameter or an invalid specification causes 
supervisor generation to be terminated. 

Specify: 

M0DEL=115 for the IBM 3115-0 and 3115-2 CPU 

MODEL=125 for the IBM 3125-0 and 3125-2 CPU 

MODEL=135 for the IBM 3135 and 3135-3 CPU 

MODEL=138 for the IBM 3138 CPU 

MODEL=145 for the IBM 31U5 and 31*^5-3 CPU 

MODEL=148 for the IBM 31U8 CPU 

MODEL=155-II for the IBM 3155-11 CPU 

MODEL=158 for the IBM 3158 CPU 

If M0DEL=115 or 125 is specified, the generation of Recovery 
Management Support (MCAE/CCH and/or EMS error recording) is 
dependent on the specification of the EMS, CHAN, and MCH parameters 
of the SUPVB macro. For all other CPU models^ EMS-support is 
standard, 

g otes; 

For reasons of compatibility with earlier DOS releases, 
specification of MODEL=155 is accepted by the assembler. Support 
for the Model 155-11 CPU is generated. 
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When MODEL=125 is specified, support for the 3330 disk is always 
generated (if not specified otherwise in the DISK=paraineter of the 
PIOCS macro). When M0DEL=115 is specified, support for the 3340 
disk is always generated. 

The storage protection and decimal features have be^n made 
standard. The Interval Timer is a standard System/370 hardware 
feature. If, however, you specify SP=, or DC= (whether the 
opt-rand is YES or NO) , the assembler will accept your 
specification and merely react by generating an MNOTE, which 
need to be resolved. TIMEE=YES is also acceptable but 
generates no code. 

If you plan to run your generated system on more than one CPU 
model, you should specify the larger model number. 



STDJC 



The STDJC (Standard Job Control) macro instruction and its parameters specify the 
standard settings for job control. If the assumed options are all satisfactory, the only 
entry required is the STDJC macro instruction itself, without any parameters. Th ese 
sta n dard options, except LINES and DATE, can be temporarily overridden by an OPTION 
statement, LINES can be overridden by a SET com m and, DATE by a // DATE statement . 



PARAMETERS FOR STDJC 



ALIGN 



ACANCEL 



CHARSET= 



( YES ) 
N=( NO/ 

i no) 

:="\YES/ 



(i|8c) 
=\60C/ 



(MDYl 
DATE= |,DMy/ 

JYESX 

DECK=\ no/ 

( XM) 
DUMP =< N0> 

(part; 



EDECK 



ERRS 



i NO) 
i=\YESJ 

ilES) 

=\ mf 

i56) 

LINES'- inn j 

(yes) 

LIST=\ Nof 

i ^\ 

LISTX=lYES/ 



Specify if the assembler is to align data on halfword or fullword 
boundaries, according to the type of instruction used. A 
supervisor must be assembled with option ALIGN=YES to avoid hard 
waits.. 

Specify if Job Control is to cancel jobs automatically 
(ACANCEL=YES) or to wait for operator intervention (ACANCEL=N0) 
after an unsuccessful attempt to assign a device. (Please note 
that the LOG command suppresses the ACANCEL function.) 

Specify either the 48- or 6 0-character set for PL/I translator 
input on SYSIPT. 

Specify the format of the date MDY=month/day/year . 
DiyiY=day/month/y ear . 

Specify if language translators are to pa:oduce object modules 
on SYSPCH. 

Specify if a dump of the registers and virtual storage is to be 
written on SYSLST in case of an abnormal program end. PART 
specifies that a dump of the supervisor control blocks and the 
virtual storage of the partition is to be written on SYSLST. 

Specify if the assembler is to create and punch edited macros 
on SYSPCH. 

Specify if compilers are to summarize all errors in source 
programs on SYSLST. Assembler and PL/I always assume ERRS=YES. 

Specify the number of lines per page on SYSLST. The minimum 
is 30; the maximum is 99. 

Specify if language translators are to write source module 
listings and diagnostics on SYSLST. 

Specify if compilers are to write hexadecimal object module 
listings on SYSLST. 
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j YES \ Specify for a listing of all control statements on SYSLST. 
LOG=\ no; L0G=N0 suppresses the listing of all job control statements on 

SYSLST. Invalid statements and coirrrands will be listed on SYSLST 
if it is assigned. 

/ no) Specify RLD=YES if the relocation dictionary information is to be 
RLD=lYES/ printed. 

^ no) Specify if the gSYSPARM assembler system variable symbol is to 
SPAR]yi= lYES/ be supported. 

(no) SYM=YES may be specified if the PL/I compiler is to produce a 
SYM=(YEs/ symbol and offset table listing on SYSLST, or if American National 
Standard COBOL is to produce a data division glossary. 

/ yes ) Specify if the assembler is to write symbolic cross-reference 
XREF=\ NO) lists on SYSLST, or if American National Standard COBOL is to 
produce a cross-reference listing. 



FOPT 



The FOPT (Optional Features) macro and its parameters specify additional optional 
features that can be included in the supervisor. 



PARAMETERS FOR FOPT 

/ NO) Specify if the abnormal termination exit function is to be 
AB=\yes| supported. The abnormal termination exit, invoked via the STXIT AB 
macro,, allows you to exit to a user's routine before an abnormal 
end-of-job causes a program to be canceled. Specify YES for 
American National Standard COBOL I/O error recovery. AE=YES is 
forced if TP=VTAiyi is specified in the SUPVR macro. 

(NO) Specify the nuumber of I/O requests for the operator console to be 
CBF=\ n/ buffered. Under the following conditions operator console I/O 
requests will be buffered: 

1. The actual record to be written does not exceed 8 characters. 

2. Data or command chaining is not performed. 

3. The CCB associated with this operation does not indicate the 
acceptance of unrecoverable I/O errors, posting at device end, 
or user error routines. 

U. The CCB does not request sense information. 

CBP^NO is forced if H0DEL=115, 125, 138, or 148 is specified 
together with D0C=125I> or 3277. 

Console buffering allows overlap of CPU processing with write 
operations to SYSLOG by satisfying the requestor's WAIT 
immediately, rather than at I/O completion time. When this option 
is selected, the number of CHANQ entries should exceed the number 
of CBF entries so that the buffering process is not bound by the 
number of CHANQ entries. If the assiomed option is taken for .CHANQ 
and CBF is selected, the number of CHANQ entries is assxaned to be 
six more than the CBF entry. Numbers 1 through 5 are valid, and 
one is assumed if the operand is invalid. 
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(NO ^Specify if supervisor DASD file protection is desired when n»,n2 

DASDFP=\ (n*,n2[, 2321 J) I indicates the range of channels to which DASDs nay be attached. 

Specification of n»,n2 provides file protection for disk devices. 
For reasons of coapatibility with previous releases, specification 
for all disk devices are accepted, but are treated as 
documentation (that is, the paraneters are ignored). File 
protection for the 2321 iiust be specified and provides protection 
for all DASD devices. DASDFP prevents writing outside the extents 
cf a file in case of program error. Extents are protected to the 
nearest cylinder except for 2321, where they are protected to the 
nearest head bank. This feature does not protect the file froa 
being bverwitten. 

Notes: 

1. No file protection is provided for the IBfl 354 Diskette 
Input/Output Unit. 

2. The lOTAB paraoeter JIB-n allocates storage for DASDFP 
extents. 

3. If a disk device type is specified by the third operand and 
this disagrees with the one as specified by the DISK parameter 
of the PIOCS sacro, the value of this paraieter will ovsrrule 
the one specified by the third operand, 

!N0 \ Specify if supervisor support for a display operator console (DOC) 

125D V is to be generated. DOC=125D and DOC=3277 generates the supervisor 

32 77 } routines that allow SYSLOG assignment to a 125DOC or a 3277, 

If DOC support is generated, support for 3210/3215 console printer 
keyboards is generated as well. If 125D is specified for a Hodel 
138 or 148, console support is provided in 115/125 DOC emulation 
fflode; for details, see DQS/VS Qfieratina Proc ed ures. The 3277 is 
supported as operator console on all Systett/370 aodels to which it 
is attachable. Support of the 125DOC and the 3277 as operator 
console coaaunication device is mutually exclusive. The APL 
feature with 3277 is not supported. 

The default taken depends on the CPO aodel specified by the HODBL 
parameter of the CONFG macro. If HODEL-115 or 125, the default is 
125D. If HODEL=138 or 148, the default is 3277, For any other 
HODEL specification, the default is NO. 

iNO ) Specification of this parameter allows use of the VIRTAD macro, the 

ECPEEAL= iTES/ fiEALAD aacro, and of the EXCP macro with the HEAL parameter. 

For good performance of the SOFT/VS program, this option 
(K:PEEAL=YES) should be specified. ECPEEAL=TES forces PFIX=IES. 
ECPEEAL=IES is forced if POWEE=TES or TP=?TAM is specififed. 

!5i This parameter is optional. It is intended primarily for tele- 

3 ? processing systems with a large number of communication lines or 

n) devices. It specifies the number of entries to be generated for the 

error gueue. The default and minimum number is 5 if the system is 
generated to support multiprogramming. The default and minimum 
number is 3 if multiprogramming is not supported. The maximum 
value of n is 25. 

Tno ) Kagnetic tape error volume analysis is supported (may be used with 

EVA= \ (r,w)/ or without TEBV) . When the number of temporary read errors that 

occurred exceeds the value of r, the operator is notified via a 
message on SYSLOG. The maximum value for r cannot exceed 254. 
EVA={r,w) forces TAPE=7, 

flhen the number of temporary write errors that occurred exceeds 
the value of w, the operator is notified via a message on SYSLOS, 
The maximum value for w cannot exceed 254, 
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F&STTR 



= \YESf 



After the operator aessage the systea resets the teaporary error 
count to zero and continues noraal processing. 

Specify if fast CCW translation is to be supported. 

Past CCtf translation atteapts to save and reuse any channel 
frograas that have been translated, and to keep the pages 
containing the I/O areas fixed, providing the paging rate is not 
seriously affected. Fast translation is atteapted for all channel 
prograas except: 

1. Those containing non-contiguous CCS strings. 

2. Those associated with translation requests froa BT&R (BTAR 
aakds special use of CCH translation) . 

Note that the specification of FASTTR=IES affects the default and 
Einiaua values for the BOFSIZE=n paraaeter in the TSTAB aacro. 

j NO ) specify TES if storage aanageaent support using the GET7IS and 

GETVIS= (lEsf FREETIS aacro instructions is desired. GET?ls=tES is forced if 

VSAM=TES, RPS=YES, or if TP=YTAH is specified in the SOPTR aacro. 

GETVIS=YES forces RELLDR=YES. For 3800 printer support, GETVIS 
storage management is required. 

Specify lES if your systea includes the IBH 33*1* or 3350 and the 
Analysis Prograa-1 (AP-1) will be invoked. 

iSQ. \ Specify ID£A=TES if the IDRA (Independent Directory Bead-in Area) 

IDEA= (TEs/ is desired. IDBA=TES allows the systea to read the directory 

containing the location of the phase specified in a FETCH or LOAD 
into the IDFA instead of using the Systea Errdr Recovery Procedure 
transient area. Thus, with the IDRA feature, throughput aay 
increase whdn .an error recovery procedure is in progress. 
IDBA-TES is valid only if the NPABTS paraaeter in the SUPTfi aacro 
specifies aore than one partition. 

I NO \ Specify if the interval tiaer can be handled by problea prograas. 

IT= (lES/ IT=YES generates tiaer support for ail tasks in ail partitions. 

It allows use of the STXIT IT and SETIHE aacros. IT=TES is forced 
if TP=¥TAH is specified in the SOP?R aacro. 

Specify TES if yon will invoke the IBB Analysis Prograa-I (AP-1) 
atid your systea InclOdds 3344s or 33503. 

Sote : For reasons of coapatibllity with earlier DOS releases, 
specification of IT^BG, F1, or F2 is accepted by the asseabler. 
Tiaer support for a^ll tasks in all partitions is generated as if 
IT=TES had been specified. 

!SQ I Specify if DOS/TS Job Accounting Interface is to be supported. 

lES ; JA^TES indicates support of each partition. 

(n«,n»,n3,n*,n«)) 

JA-(n>,n',n3,n'*,nS} specified additional support of SIO count for 
I/O devices, and JA^TES is generated. The values substituted for 
n*,n>,n',n*, aind n* indicate the naaber of i/o devices per 
partition for which SIOs are to be counted. The aaziaua value for 
n for any partition is 255; n* always specifies the naaber for the 
background partition. 

Tbe partitions to which n^ through n« refer depend on the naaber 
of partitions in the systea, as is shown below: 

n* n' n* n» 



2 


partitions 


F1 






3 


partitions 


F2 


F1 




4 


partitions 


F3 


F2 


F1 


5 


partitions 


r4 


F3 


F2 



F1 
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If no SIO count is required for a given partition, no value should 
be supplied. However, the operand delimiter (comia} nust be 
submitted if other values follow. 

For example, if HPAETS=5 and JA=(10,,3) are specified, STO count 
is supported for: 

10 I/O devices for the background partition 
I/O devices for the F4 partition 
3 I/O devices for the F3 partition 
I/O devices for the F2 partition 
I/O devices for the PI partition 

If you plan to use the job accounting support of POWEF/VS, specify 
either JA=YES or Jk-n ,n ,... 

(NO ) Specify for support of user-written job accounting routines 
jaLIOCS= ({s,1)/ containing LIOCS, and LIOCS with label processing. If you specify 

jaLIOCS= (s,l) , JA=YES or (n>,n2,n',n*,n') must be specified as 

well. 

s and 1 reserve a user save area and a label area equal to their 
specifications (that is, if s equals 25, then a 25-byte save area 
is reserved), s can be any decimal number in the range 0-102U, 
If s is omitted, or if JALIOCS=HO, a T6 byte user save area is 
still reserved in the supervisor if JA#!IO is specified. 1 can be 
any decimal number between and 224. 

|N0 \ Specify if operator-initiated communication is to be handled by 

0C= uES I problem programs. Allows use of the STXIT OC macro. If YES is 

specified, the facility is available to all partitions generated. 
YES is required if emulator program operator services are to be 
requested through the interrupt key. If FETRI!f=YES, OLTEP=YES, or 
1P=VTAM is specified, OC=YES is forced. 

(YES) Specify OLTEP=YES if the online testing function is desired. 

OCTEP= (NO { CLTEP*YES allows the online test executive program to execute. 

If OLTEP^YES, then RELLDfi=yES and OC=YES are forced. 
Specification of BETAIN=YES forces OLTEP=YES to be generated. 

iNO ) Specify if user prograES may use STXIT PC macro. QTAH, RPG II, 

PC= (YES( FOETBAN IV, COBOL-D, and PL/I require PC=YES. If TP=VTAH is 

specified in the SUPVfi macro instruction, PC=YES is forced, 

(NO ) Specify if private core image libraries are to be supported. These 

PCIL= \ YES ( have the same format as the system core image library on SYSPES. 

You may assign private core image libraries to any partition. If 
the linkage editor is to run in a foreground partition, a private 
core image library must be uniquely assigned to that partition. 
You may link-edit many iBB-supplied programs to run in a 
foreground partition and place them in a private core image 
library to be assigned to that partition. PCIL=NO forces PSLD=NO. 

(NO ) The PD parameter must be specified if the problem determination 

PD= (YES/ programs (PDAIDS) are desired. PD=YES specifies that a minimum 

FDAEEA or 1,400 bytes is reserved for this function. Any amount 
between 1,400 (SDAlDs do not need a generated area) and 10,240 
bytes may be specified for n. 

|N0 ) Specify if the supervisor is to support the fixing and freeing of 

PFIX= (Yis/ pages by means of the PFIX and PFFEE macro instructions. PFIX=YES 

is forced if POHEE=YES, PHO=YES, or TP=7TAH is specified 
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PRTT= 

(partition nane 
sequence) 



in the SOPVR aacro or if ECPBEAL=YES is specified, PPIX=YES is 
required if you plan to execute BTAH programs in virtual node. 

Specify, by means of a partition name sequence, the desired 
dispatching priority for each partition. The partition specified 
first has the lowest priority, the partition specified last has 
the highest priority. Specify all the partitions for which support 
is generated by means of the NPAETS parameter of the SDPVE macro 
or by default; do not specify PBTY if NPARTS=1. 

the partition default priority is as follows: 



Sumbe£ of 
partitions 



Default priority (low to hiah) 



BG,F1 
BG,F2,F1 
BG,F3,F2,F1 
BG,F4,F3,F2,F1 



psr. 






liELLDfi 



<YES) 



EETAIN 



/NO ) 
= \XEsi 



{no ( 

fiPS= I YES/ 



Specify the number of entries in the Private Second Level 
Directories. A directory is created for each partition, unless 
PCIL=NO, The ffliniaua value for n is 5. PSLD=HO is assumed if the 
parameter is omitted or incorrectly specified. For good 
performance n should be equal to the largest number of actually 
used directory tracks of a private core image library. PCIL=NO 
forces PSLD-NO, 

Specify if the supervisor is to include the relocating loader. This 
facility allows programs to be loaded into partitions, independent 
of their link-edited addresses. SEtLDE=YES is forced by BPS=YES, 
YSAn=YES, GETyiS=YES, OLTEP=YES, EETAIN=yES, or TP^VTAH. 

Mote : If the supervisor is generated to include the relocating 
loader, the function can be suppressed at link-edit time by means 
of an »ACTION NOEEL' Statement. 

The EETAIN function is available on the Model 145 in the United 
States of America and Canada only. BETAIN is an OLTEP function that 
allows the OLTEP programs initiated from a remote location to be 
executed. RETAIN is a problem determination tool used by IBM. If 
this function is to be used, specify BETAIN= YES and include the 
IBM 2'955 Retain Communications Device in the FOB table. External 
interruptions are required for RETAIN operation; therefore, if 
BETAIN=YES is specified, OC=YES, OLTEP=YES, and RELLDE=yES are 
forced. 

Specify to include support for the Rotational Position Sensing 
capability of IBH 3330/3333, 3340, and 3350 Disk storage devices. 
EPS support permits the device to disconnect during access are 
positioning operations, thereby freeing the channel to service 
requests for other devices on the channel during the latency 
period. If RPS=YES is specified, GETVIS=YES and EELLDR=yES in the 
FOPT macro and BLKMPX=YES in the PIOCS macro are forced. 



yptes: 

1. The EPS support is suppressed if the NPAETS parameter in the 
SUP7E macro specified support for one partition only 
(NPAETS=1) . 



42 DOS/¥S System Generation 



2. Specification of RPS=YES eliminates the need to specify 
SKSEP=YES for devices that have the RPS feature and block 
multiplexing support. SKSEP=YES can be specified for DASD 
devices that do not have the RPS feature or for DASD devices 
connected to selector channels or IFAs, in order to free the 
channel during seek operations. 

3. Specification of EPS=YES is required if your system includes 
DASDs of type 3330-11 or 3350 and you intend to use these 
devices for processing sequential or direct-access files «ith 
programs that were written for accessing these files on other 
IBM DASD types without recompiling or reassembling these 
programs. 

no ) specify if SEEKs are to be separated from the remainder of channel 
SKSEP=^YES/ programs. Seek separation allows other devices on the channel to 

n* be accessed (including other seeks) during the seek. YES indicates 
support for all DASD type devices specified by the DVCGEN macro at 
system generation time. n is the number of DASD devices to be 
supported and cannot be less than the number of DASD devices 
specified at system generation. The maximum is 2 54. 

Note ; If all DASD devices in your configuration have DCC 
(Disconnect Chaining) capability and if they are attached to block 
multiplex channels, channel overlap during SEEKs is more 
efficiently handled by Block Multiplex Channel Support (specify 
BLKMPX=YES in the PIOCS macro). In a mixed DASD configuration, 
that is a configuration consisting of DASDs with and without DCC 
capability, specify either SKSEP, or SKSEP and BLKMPX. 



.M 



Specify the number of entries in the Second Level Directory. The 
SLD=ln/ minimum value for n is 5. This is the default value if the 
parameter is omitted or incorrectly specified. For good 
performance n should be equal to the number of actually used 
directory tracks in the system core image library. 



i no) specify SYNCH=YES if the use of an IBM-provided program requires 
SYNCH=(YESj the synchronous exit facility (SVC screening). 



(NO 1 
<YES > 
'{YES,ni,n2)) 



Specify if system input and system output files (SYSRDR, SYSIPT, 

SYSFIL={yES } SYSLST, SYSPCH) in any partition may be assigned to a disk device 

or an IBM 3540 Diskette I/O Unit, or, if support for the procedure 
library is desired. Specification of YES gives support for all 
disk devices and the IBM 3540 Diskette Input/Output Unit. In a 
configuration without tape, specification of SYSFIL=YES is required 
for system maintenance purposes. If the emulator program parameter 
SYSIO is specified with a value ranging from 200 through 233, a 
value must be specified for SYSFIL. 

Ui = residual capacity for beginning of operator notification when 
SYSLST assigned to disk. 100<ni <65535. If n^. is omitted, 
1000 is assumed. 

n^ = residual capacity for beginning of operator notification when 
SYSPCH assigned to disk. 100<n2 <65535. If n^ is omitted, 
1000 is assumed. 

Notes ; 

1. If neither n^ nor Uz is specified, the operand need not be 
placed between parentheses () . 

2. Neither n^ nor n^ may be specified if the logical units are 
assigned to an IBM 354 Diskette Input/Output Unit. 

(noV Specify if tape error statistics are to be accumulated and logged 
TEB=\ nf for the 2495 Tape Cartridge Reader, where n is the number of tape 

cartridge readers attached to the system. Choose a value of n that 
allows for possible future expansion of the system. 
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^IR) Specify how tape statistics are to be automatically accumulated 
TEBV=\cr/ in the PUB2 table and logged on the SYSREC file. For all standard 
labeled tapes, tape statistics are accumulated by volume. For 
unlabeled or nonstandard labeled tapes two types of error recording 
are available: 

• Combined Recording (CR) 

• Individual Recording (IR) 

When TEBV=CR is specified, the error statistics for all nonstandard 
and unlabeled tapes on a specific tape unit are accumulated until a 
standard labeled tape is mounted and opened on that unit. Then one 
recording of the statistics for the nonstandard, unlabeled tapes is 
made and the counters are reset in the PUB2 table. 

Specify TEBV=IR to record tape error statistics on the SYSREC file 
and reset the PUB2 table counters at each OPEN for nonstandard and 
unlabeled tapes. 

i NOl Specify if time-of-day clock support is desired. If YES is 
TOD='\YEs/ specified, GETIME macro support is provided. Every time a GFTIKE 
is issued, the date fields in the supervisor communication regions 
are updated, if necessary. TOD=NO forces ZONE=JSiO. If TP=VTAiy! is 
specified in the SUPVR macro instruction, TOD=YES is forced. 

(no) Specify if the track hold function is to be supported. 
TRKHLD=\ n/ Specification of TRKHLD generates support for the DASD Track 

Protection macros. When processing sequential disk work files or 
updates to direct-access files,, specify if a hold is to be placed 
on the track of the record being read. The hold prevents anyone 
else that is using track hold from accessing that track. Tne 
maximum number of tracks that can be held at one time is 2 55. The 
default is 10 if n is an invalid parameter (nonnumeric or outside 
the range 1-255). The NPARTS parameter in the SUPVR macro must 
specify more than one partition if TRKHLD=n is specified- 

Note: The track hold function is not supported for the IBM 354 
Diskette I/O Unit- The track hold function must be specified if 
VSAM files with the attribute SHAREOPTIONS (U) are processed. For 
details refer to DOS/VS Access Method Services U s er's Guid e, 
GC33-5382. 

(NO \ Specify if the task timer support is to be generated in the 
TTIME=\partition IDf supervisor. The partition-ID (BG, F1^ F2, etc.) designates the 

partition that owns the task timer. 

Support must be generated for the partition that owns the task 
timer by corresponding specification in the NPARTS parameter of the 
SUPVR macro. For example, with NPAETS=2 specified, valid 
partition-ID specifications are BG or F1; if NPAETS=3 is specified, 

partition- ID, BG, F1 , or F2 is valid. If the partition designation 
does not correspond to the appropriate NPARTS specification, or if 
the value specified for NPARTS is invalid, an MNOTE is issued. 

The task timer requires that the clock comparator (an optional 
hardware feature) and the CPU timer be installed on the System/370 
Models 135 and 145. 

USERID=id Specify if you want a supervisor id to be printed as part of the 
IPL COMPLETE message. id may be up to 16 bytes long. If you 
specify more than 16 bytes, the id will be truncated on the right. 
If you specify less than- 16 bytes, the id will be padded with 
blanks on the right (do not place the id within quotes, embedded 
blanks are not allowed) . 
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The specified id is placed in the 16 byte area that immediately 
precedes the background communication region. The field contains 
blanks if tl>e parameter is not specified. 

/• ^\ Specify if support of VSAM (Virtual Storage Access Method) or of 
VSAM=tYES/ the 3800 Printing Subsystem is desired. YES is forced for 

GETVIS and RELLDR if VSAM=YES is specified. If NRES is not, or 
incorrectly, specified in the lOTAB macro, VSAM=YES forces NRES=10. 
For 3800 support, VSAM=YES is required so that the CDLOAD routines 
are included in the supervisor. If VSAM support is not wanted, 
the VSAM phases can be deleted (see "Link-Edit and Delete 
"procedures") . 



/ no) Specify if the multiple wait function is to be supported. This 
WAITM=\YEsf function allows you to use the WAITK macro to wait for one of a 
number of events to occur. WAITM=YES is forced if AP=YES or if 
TP-VTAM. 

* 

Specify T£S If you vill invoke the XBH Analysis Progran-I (AP*1) 
and your systea inclades 3344s or 3350s. 

no ) Specify YES or n if support for Cross-Partition Event Control is 
XECB=<YES> desired. If YES is specified^ four XECBs (Cross- Partition Event 
n; control Blocks) are generated per partition (as specified in 
NPARTS) . 

For n, specify a nnaeric value; it indicates the nuaber of XECBs 
for vbich an entry is to be generated in a supervisor internal 
table. The slnisua nuaber you should specify for n is 4. If you 
specify less than four, the specification is ignored and XECB-4 is 
assuaed. The aaxiaua nuaber you should specify for n is 8*MPABT5. 
If you specify a nuaber greater than e*NPARTS« the specification is 
ignored and 8*HPAItTS is assuaed. Cross-Partition Event Control is 
not supported If WPASTS»1 is specified. XECB support aust be 
specified if SPOOL- YES (in the POWEB/VS generation aacro POVER) is 
spacified. 

Specify YES or n if you plan to utilize the cross-partition 
support of POWER/VS. 



!N0 
(EASTfhh^mm) 
(WEST«hh,mm) 



For time-of-day clock support, specify the difference between 
GMT (Greenwich Mean Time) and local time in hours (hh) and 
minutes (mm) . Specify EAST for areas to the east of the meridian 
of Greenwich, United Kingdom, or for areas whose time is in advance 
of GMT. Specify WEST for areas to the west of the meridian of 
Greenwich, United Kingdom,, or for areas whose time is behind GMT. 
The value used in the ZONE parameter is used to obtain the local 
time of day. If the parameter is not specified, or incorrectly 
specified, or if TOD^NO is specified, ZONE=NO is forced. If the 
first operand is incorrectly specified, EAST is assumed. 

You can change the zone value (default is GMT) every time you 
perform the IPL procedure, by specifying any zone value in the ZONE 
parameter of the SET control statement. 



Notes: 

1. Information on the macro instructions STXIT* EXIT, SETIME, and TTIMER is contained in 
the DOS/VS Supervisor and I/O Macros .. 

2. The PTO (Physical Transient Overlap) feature and command chaining support for retry 
on I/O operations (CCHAIN) , optional in earlier releases of DOS, have been made 
standard. If, however, you erroneously specify either PTO or CCHAIN (whether the 
operand is YES or NO), the assembler will accept your specification and react only by 
generating an MNOTE, which you need not resolve. 
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PIOCS 



The PIOCS (Physical Input/Output Control System) macro instruction and its parameters 
define the configuration requirements to be supported by physical IOCS. If the assumed 
options are all satisfactory, the only entry required is the FIOCS macro itself, without 
any parameters. 



PARAMETERS FOR PIOCS 



BLKMPX= lYES/ 



Specify if block multiplexing is to be supported. Bloclc 
naltiplexing is useful in a configuration with 3330, 3310, and 3350 
Disk Storage devices and the following buffered card and print 
devices: 25U0, 1403, 3211. 

Note 1,: In a DASD configuration that consists of 3330, 3340, and 
3350 Disk Storage devices, there is no need to specify SKSEP=YES or 
n in the FOPT macro as block multiplexing provides channel overlap 
during SEEKs in a more efficient way. Moreover, the code generated 
by a specification of SKSEP=YES is then bypassed if BLKHPX=YES is 
specified. 

Note 2 ; If your CPU is a Model 3115 or 3125, Block Multiplexing 
must not be specified in conjunction with the use of the 
2311-1/3330, 2311-1/33U0, and 2314/3340 Series Compatibility 
Features. 

i MPI Specify if burst mode devices are supported on a byte-multiplexer 
BMPX=tYEsf channel. If overrunnable devices are attached to the 

byte- multiplexer channel, BMPX=YES should be specified. However, 
burst mode and MICE devices cannot run concurrently on the same 
byte-multiplexer channel. Specify BMPX=YES if: 

• Attached devices operate in burst mode, or 

• Overrun problems have been experienced. 



Otherwise specify BMPX=NO. 

no ) Specify if channel switching for tape control units is to be 
CHANSW=< RWTAU; supported. For a 2404 or 2804, enter CHANSW=RWTAU. For a 2816 
ITSWTCh) (with a 2403 or 2803) or a 3803 enter CHANSW=TSWTCH. If 

CHANSW=RWTAU or TSWTCH is specified and TAPE=NO is specified, 
TAPE=7 is forced. Channel switching allows a device to be 
addressed via two adjacent selector or block-multiplexer channels. 



4 



DISK= 



2311 

2314 

3330 

3340 

3350 

(3330,3340) 

(3330,3350) 

(3340,3350) 

(3330,3340,3350) 



Support for the IBM 2311, 2314/2319. Specification of DISK=33xx 
gives support for all attachable DASD devices of the type 
specified. If support for more than one type of DASD device is 
required, each type must be specified. For example, to provide 
•support for 3330s and 3340s, specify DISK= (3330,3340) . This 
provides no support for 3350s. 

Note: DISK=3340 is the only valid specification for the Model 115. 
Specification of DISK=2311 , 2314, or 3350 is not valid for Model 125, 
If Model=115 and DISK7^3340, DISK=3340 is forced. If MODEL=125 and 
DISK?^3330 or 3340, DISK=3330 is forced. 



/ li^l Specify if MICR device is on the selector channel (can only be 
MRSLCH=(YEsf specified for the 1419 single address device). 



TAPE= 



I'! 

(no) 



Specification of TAPE=7 generates support for both 7- and 9-track 
tape. TAPE=7 is forced by a specification of EVA=(r,w) and by 
CHANSW=RWTAU or TSWTCH. If MODEL=125 or 115 and TAPE=7, or 9, 
CHAN=YES must also be specified. In a configuration without tape, 
specification of SYSFIL=YES is required for system maintenance 
purposes. 



46 DOS/VS system Generation 



Page of GC33-5377-6, revised July 15, 1977, by TNL GN33-9226 

li2i§ !• Selector channel support is standard in DOS/VS. The paraaeter SELCH=, 
used in prior DOS releases, is ignored. 

Sotg 2: A Display Operator Console (DOC) must not be attached to the saae selector 
or block nultiplexer channel as SYSBES. 



VSTAB 



The VSTAB (Virtual Storage Table and Buffer Build) macro instruction and its paraieters 
define the size of the teal and virtual address areas and of the SVA (Shared Virtual 
Area), and specify the nuaber of buffers required for channel program translation. 
Tables, for mapping the real and virtual address areas, and buffers are generated within 
th^ supervisor area. The maximum value you can specify for VSI2E is 16,38ftK (16,777,216 
byteS) minus the size specified for the real address area (PSI2E) . Specification of this 
jacgo is ESauiced. The VSTAB macro is discussed in greater detail in the D O S /V S Sigtem 
Han^geaent G ui de. 



PARAHETEfiS FOB VSTAB 

VSTAB HSIZE=/96Kl ,VSIZE=/NPABTS*61|K*-SVA sizelf ,BlIFSIZE»n ],SVA=/i64KxOK),) 
(nK"^) (nK~ / ( 7nK,iBK) / 

BSIZE=nK Specify the size of the real address area, where n must be > 6ft and a 

multiple of 2. If an odd nuaber is specified, a value of 1 is 
added to it. If the operand is omitted, a value of 96K is 
assumed. The value specified is used to build the tables that map 
the real address area and to define the beginning of the virtual 
address area. (End of real address area = beginning of virtual 
address atea.) 

If you select a value for RSIZE that is larger than the amount of 
real storage in the CPO model used for system generation (with an 
eye to also using your system on a CPtJ with larger real storage) , 
the address area between the end of real storage and the beginning 
of virtual storage will not be used. 

If you select a value for RSIZE that is smaller than the actual 
amount of real storage in the CPtr on which your system is to be 
used, any real storage beyond your BSTZE cannot be used, and a 
warning message is issued at IPL time (provided that you IPL from 
the console keyboard), informing you that a part of real storage 
is not used. If you IPL from the card reader, however, the 
message is suppressed. 

VSIZE= (IPAB25*64Kj Specify the size of the virtual address area (which includes the SV\), 
< ♦SVA, size > where n must be at least 64 times the number of partitions specified 
(nK ) fcy the NPAFTS parameter and a multiple of 2, plus the size of the 
SVA. If an odd number is specified, a value of 1 is added to it. 
If VSAH is to be used, the partition in which it is to run should 
have 302K bytes plus sufficient space for buffers and control 
blocks (see book Hodule 17: VSAH) ; if the VSAH phases are to be 
loaded into the SVA, the latter must have 302K bytes. 

If Access Hethod Services is to be used, it requires up to USOK 
bytes in the partition in which it is to run, depending on the 
functions that are to be performed (refer to the section "Storage 
Eeguirements' in book Hodule 17: VSAH) . If the operand is 
emitted, a value of 64 times the number of partitions specified by 
the NPASTS parameter is assumed. The value specified is used to 
tuild the tables that map the virtual address area, to determine 
the size of the disk extent for the page data set, and to define 
the end of the virtual address area. 
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BUFSIZE=n Specify the nunber of copy blocks (buffers with a length of 7 2 

bytes) to be used by the Channel Prograa Translation routine. 
Specification of this paraaeter is optional. For further details, 
refer to DOS^YS S^stea Hanaqe m e nt Gu ide, Chapter 3 under •Defining 
the Number of cci Translation Buffers*; 

The following table shows the niniauH value that can be specified 
and the default value that is used if the operand is oaitted. 



1 

IFASTTR= 


1 

IMPARTS- 


1 
= 1 


BDFSIZE= 
Default 


HininuB 


I — — - — 
JNO 


I 


n=1 


1 


10 




1 


10 




i 


n>1 


1 


30 




1 


10 


1 ""•""*"* 
lYES 

1 _______ 


1 


n=1 


1 


30 




1 


30 


lYES 


1 


n>1 


130 


♦ ((n-1)«20) 


1 


30 



The naxittUD value that nay be specified for BOFSIZE is 4 50. For 
EPS add 20X aore buffers. For teleprocessing terminals supported 
under BTAR specify three blocks for each locally-attached 2260 or 
3270. For reaote devices specify three blocks plus one additional 
block if the DECB extension facility is used, plus one additional 
block for each BTAH buffer specified for the device. If VSA«=YES 
is specified, add ^0 blocks. VSAH uses these copy blocks only 
during actual I/O and iaaediately frees thea after use. 

If the terminals are attached to aultidrop lines, copy block 
assignaent should be by line, not by device. For large 
teleprocessing network it is soaetiaes possible to assign fewer 
buffers. One way to deteraine if enough buffers have been 
specified is to use the DOHP coaaand, specifying the begin and end 
address of the buffer area in the supervisor. If all blocks have 
been used then probably too few buffers were specified. 

SVA= (i6U5xO£Il nK specifies the size of the SVA; aK specifies the size of the 

((nK.aK) / system GETVIS area in the SVA. n aust be at least 64 and a aultiple 
of 2. a mii&t be saaller than n and also a aultiple of 2. If the 
operand is oaitted or incorrectly specified, the default value is 
taken. If the SVA is to be used for VSAH phases, specify 
STA= {302K,0K^ . 

The systea GETVIS area aust be large enough to accommodate all RPS 
logic module phases that will be dynamically loaded, plus at least 
2K aore for the LDL used by EPS. A specification of SVA=(nK,<»OK) 
is adequate for a typical program. If all the RPS logic nodules 
are to be pre-loaded, as for example when using 
Checkpoint/Restart, a specification of SVA= ({n + 88) K,6K) will be 
adequate. 

Kote J.: This parameter is only valid if the NPARTS paraaeter of 
the SDPVR macro specifies more than one partition (NPAFTS>1). The 
size specified can be changed by the SVA paraaeter of the SET job 
control coaaand. 

yote gz If TP=VTAH, the value calculated for the VTAH space 
reguireaent in the SVA aust be included in the specification of 
the SVA. 
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ALLOC 

The ALLOC (Allocate) macro instruction defines the partitioning of the virtual address 
area in a multiprograitiitiing system. Specification of th is macro is opt i onal beca u se the 
operator can also allocate the virtual storage address area. It can only be specified 
with at least one parameter. Specify the size of the virtual foreground partitions only. 
The system computes the size of the virtual background partition by subtracting the total 
amount of virtual storage allocated to the virtual foreground partitions from the virtual 
address area as specified by the VSIZE parameter. When specifying the ALLOC macro, see 
to it that the size of the background area does not fall below 64K bytes. If VSAM with 
Access Method Services is to be used, the partition in which they are to run should have 
U80K bytes plus enough space for buffers and control blocks. If VSAM phases are loaded 
into the SVA, the SVA must have 302K bytes and the partition 302K bytes plus enough space 
for buffers and control blocks. If the macro is omitted, the entire virtual address area 
is allocated to the virtual background partition and the size of each virtual foreground 
partition defined is set to zero. The ALLOC macro must not be used if NPARTS=1 is 
specified, 

PARAMETERS FOR ALLOC 



ALLOC Fn=iBK[ ,Fn=mK]... 



The operands may be specified in any order, m must be a multiple of 
2. If an odd number is specified, it is replaced by the next 
higher even number. The minimum value substituted for m may not be 
less than 64, A zero specification is accepted, however. Any 
specification from 1 through 63 is reset to zero, n is the 
partition number and can range from 1 to NPAETS-1. 

If the sum of the sizes specified for all foreground partitions plus 
the SVA plus 64K exceeds the size as specified by the VSIZE 
parameter,, the ALLOC macro is ignored by the assembler, which issues 
an MNOTE to that effect. 

Areas Used by the System 

All partitions contain a partition save area for program name, 
interrupt status information, and registers, as well as a label save 
area for label processing if the LBLTYP job control statement is 
used. Both areas are at the beginning of the partition. 

Save area length is 88 bytes, or 120 bytes* if the floating-point 
feature (FP=YES) was specified in the COiSlFG macro. 

+ Please note that no floating-point register save area is created 
for a one-partition system (NPARTS=1). 

Labe l area length is determined by the system according to the LBLTYP 
specification: 

• TAPE (standard tape labels) =80 bytes 

• NSD (nn) (nonsequential disk) =84 bytes plus 20 bytes per EXTENT 
statement 

• Omitted = bytes. 

The size of each virtual partition must be large enough to contain 
both the program and the save areas. 
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ALLOCR 

The ALLOCR (Allocate Real Storage) macro instruction allocates available real storage to 
your partitions (as defined by the NPARTS= parameter of the SUPVR macro). 

In a multiprogramming system, available real storage is the real storage size of your 
CPU as specified by the RSIZE parameter of the VSTAE macro, less the size of your 
supervisor. In a single partition system (NPARTS=1) specification of the ALLOCR macro is 
not accepted. All available real storage is always allocated to the background real 
partition- 

The ALLOCR macro instruction is optional, since available real storage can also be 
allocated or reallocated by means of the ALLOCR command. ALLOCR must be specified with 
at least one parameter. Specify the size of each real partition you desire (including 
the background partition). If a partition is omitted, it is allocated a real partition 
size of zero. All available real storage not allocated to real partitions is allocated 
to the main page pool. In order to determine the minimum size required for the main page 
pool, refer to "Planning the system" in Chapter 3 of DOS/VS Systeg Managenent Guide. 
Programs executing in virtual mode and using the PFIX macro instruction require an 
allocated real partition whose size is not less than the maximum number of pages 
concurrently fixed by PFIX. 

All of available real storage may be allocated to real partitions except for a minimum 
page pool requirement as indicated below: 

• If PFIX=NO -- 18K tainus the size of the smallest real partition of 0-18F. 

If SDL is active, the main page pool must be at least 4K. 

• If PFIX=YES and AP=NO — 18K. 

• If PFIX=YES and AP=YES — 20K. 

• If phases from the SVA are to be executed and AP=NO — 18K. 

• If phases from the SVA are to be executed and AP=YES — 20K. 

In a single partition system (NPARTS=1) , all available real storage is permanently 
allocated to the background real partition (EGR). 

During IPL, the partition allocations of real storage are checked to assure that 
sufficient storage for the page pool has been reserved. If the allocation exceeds the 
maximum allowed, all real partitions are set to zero, and a message is issued. The 
operator can correct the problem with an ALLOCR command. 

PARAMETERS FOR ALLOCR 

ALLOCE BGH=mKj; ,fnR=inK j. . . 

The operands may be specified in random order, m must be a multiple 

of 2. If an odd number is specified, it is replaced by the next 
higher even number. For each real partition allocated, the 
corresponding virtual partition must be allocated too, because the 
job control program runs in virtual mode, 

n is the partition number and can range from 1 to NPARTS-1. 

Areas Used by the System 

The size of each active real partition must be large enough to 
contain both the program to be executed and the partition and label 
save areas (see the description of the ALLOC macro) . 
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lOTAB 



The lOTAB (Input/Output Tables) macro instruction and its parameters define the area for 
the necessary device tables for the system. If the assumed options are all satisfactory, 
the only entry required is the lOTAB macro itself without any parameters. 

PARAMETERS FOR lOTAB 



BGPGR 



flOl Specify the number of symbolic programmer logical units (SYSOOO- 
=\ nf SYSnnn) assigned to the background partition. The minimum number 



-M 



BSCLNS 
(Models 115 
and 125 only) 



CHANQ=| 8 



10] 

8 

nl 



IS 



10. The aaxiiUB depends on the nuaber of partitions, 
discussion of paraaeter FnPGB, below. 



See the 



If the TP parameter in the SUPVR macro indicates BTAM or QTAM 
teleprocessing support, or if POWER/VS is used for RJE applications, 
and the MODEL parameter of the CONFG iracro specifies 115 or 125, 
this parameter specifies the number of BSC lines in the system. The 
value given must be in the range of 0-4 for the Model 115 and 0-6 for 
the Model 125. (This parameter is not required for VTAM, ) 

Specify the maximum number of entries to be generated for the 
channel queue. If the paraaeter is oaitted, a default is taken as 
follows: 

The value specified by the CBF paraaeter of the FOPT generation aacro 
plus 

6 if KPARTS«3 or less 

8 if NPA£TS=4 
10 if MPAfiTS=5 

The default value is also taken if the specified value is saaller 
than the default. 

The number of entries specified should exceed the total number of I/O 
requests you wish to accumulate simultaneously. The requests for I/O 
commands for all channels are stored in this queue and are not 
released from the queue until the I/O operation has completed. The 
maximum value generated is 255. (See the DOS/VS System Management 
Guide , for a detailed discussion of this parameter. ) 



D2311=h 
D2314=n 
D2321=n 
D2a00=n 
D3330=n 
D33U0=n 
D3350=n 
D3itl0=n 
D3a20=n 
D3540-n 
D3800=n 
D3886»n 



Specify, for the I/O device types listed at the left and as 
applicable to the installation configuration, the number of drives 
(for disk and tape devices) or the number of units installed (for 
3540s, 3800s, and 3886s). 

If the device is not specified, the system assumes that no devices 
of that type are attached. However, defaults other than zero are 
taken depending on the CPU Model specified and (for tape devices) 
whether PIOCS tape support is generated or not (see table below) : 



I Default I PI OCS 
1 I 
I I 

I TAPE 



I 

I 

|D2314»2t 
I \ 

|D2400»4| 

I I 

|D3330-2i 

I I 

1D3340»2| 
I 



S) 



— ♦ 

|D3410«2| 



C0VF6 Bacco 



H0DEL«1 15 1 H0DEL«125 



HODEL*135, 138, 145, 148, 
155-11, or 158 
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I The number specified for each device may be more than the actual 

number attached, but if the tota l number of devices specified exceeds 
the number of devices specified in the lODEV parameter, the latter 
number is upgraded (total number of devices specified by the Dxxxx 
parameters plus 5 for unit record devices) . 



FnPGB 



-i^l Specify the number of symbolic programmer units (of the class SYSnnn) 
~\mf for the foreground partition F1. The ainiaaB value for ■ is 5, and 



the aaxiaua is 241. 



Specify the nuaber of syabolic prograaaer logical units (of the class 
STSnnn) for the reaaining foreground partitions. Again, the ainiaua 
▼alue for a is 5, vhile the aaxiaua depends on the nuaber of 
partitions specified. 

The aaxiaua nuaber of ptograaaer logical units is 241 for partition 
F1; for the reaaining partitions, the sua of logical units you can 
specify is 

241 if NPAETS=1 

241-14*(n-1)-1 if NPARTS=2 or aore. 



lODEV 



-H) 



In the foraula, n equals the value specified in the NPABTS 
paraaeter. 

If the nunber of foreground prograaaer logical unit exceeds the 
nuaber of 6G LUBs, STSnnn in the extent stateaent vill fail in the 
checking routine when running // OPTION STDLABEL. The user can sake 
the 6GPGR equal to the FnPGB or use // OPTION PARSTD in the 
foreground partition. 

Specify the nuaber of I/O devices attached to the systea. The 
aaxiaua is 254. The ainiaua value ±s 4. Each unit requiring a 
DTCGEN or ADS entry aust be included in n. 



JIB 



-M 



NRES= 



m 



Specify the number of JIBs (Job Information Blocks) for the system. 
Requirements are: 

1. One JIB for each logical unit temporarily reassigned by a 
// ASSGN statement. 

2. One JIB for each alternate logical unit assignment. 

3. One JIB for each open 2311, 2314, or 2319 extent with the DASD 
file-protect feature except for system input/ output extents. 

4. Two JIBs for each open 2321 or 33xx extent with the DASD 
file-protect feature. 

The minimum value generated is 5. The maximum is 255. 

Indicates the number of Resource Usage Records (RURs) . This 
parameter is only valid if VSAM was specified in the FOPT macro, r 
must be a value between 2 and 255. If NRES is not specified and 
VSAM=YES, NRES=10 will be assumed. To compute the optimal upper 
limit for n, apply the formula 

n=(2*UCAT*NVRLC*l)*P+NVRLC+NUPGS+l 
where 
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UCAT is the number of user catalogs that are open at the same time. 

NVRLC is the nximber of volumes of a recoverable catalog that contain 
an open VSAM file. 

P is the number of partitions. 

NUPGS is the number of upgrade sets that are open at the same time. 

All these values should reflect the situation that exists at a point 
in time when NPES assumes its maximum value. 



SSLNS 
(Models 115 
and 125 only) 



Afl 



The value for NRES thus calculated will cause sufficient space to be 
reserved for the variable resources to be used. However, depending 
on the application, the number of resources actually required most of 
the time may be much lower. 

Note: If the value substituted for n is too small and the pool of 

named resources gets exhausted, the VSAM partition is canceled with 
message 0S16I displayed, unless there is a possibility of a resource 
being freed by another partition. 

If the TP parameter in the SUPVR macro indicates BTAM or QTAM 
teleprocessing support and the MODEL parameter of the CONFG macro 
specifies 115 or 125. This parameter specifies the number of Start/ 
Stop lines in the system. The value given must be in the range 0-8 
for the Model 115 and 0-16 for the Model 125. (This parameter is not 
required for VTAM.) 



DVCGEN 

The DVCGEN (Device Generation) macro instruction and its parameters define the physical 
input and output units attached to the system. This macro instruction is optional. The 
DVCGEN macro is further discussed in the DQS/VS System Management Guide . 

PARAMETERS FOR D VCGE N 

CHUN=X'CUU' ,DVCTYP=^xxxxxx,,CHANSW=|NO I ,MODE=X'ss' 

\yes/ 

CHUN=X'cuu' Specify the hexadecimal number of the channel and unit for the 

device. If channel switching is supported, c must indicate the lower 
channel. 

DVCTYP=xxxxxx Specify the type of device. Figure 1-4 contains the codes for each 

IBM-supported device. 



CHANSW^ 



: (YES/ 



Specify if the device is attached to more than one channel on one 
system, that is 

a. Two selector channels 

b- Two block multiplexer channels, or 

c. One selector channel and one block multiplexer channel. 

Note ; DOS/VS requires that the channels have consecutive addresses 
(for instance channels 1 and 2). 



This parameter indicates whether the device can be switched (IBM 2816 
(with a 2403 or 2803), 3803, 2804 or 2404 is available! . 
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MODE= 



X'SS' 
X'ssss* 

X* ssssss* 



1. 2400T9. MODE specifies the tape irode. X'CO' is the default 
value. For 800 bpi 9-track single density, specifying X'C8' 
saves time during tape OPEN. 

2. 3ttlOT9. MODE specifies the tape irode. X'CO* is the default 
value. 

3. 3U20T9. HODE specifies the tape mode. X»DO» is the default value for 
both single and dual density tape. 

4. 2400T7 or 3420T7. MODE specifies the tape mode. X'90' is the 
default value. 

5. 2702. MODE designates the SADxxx comniand. 

X'OO" SADO (default) 

X*01' SADl 

X'02' SAD2 

X'03' SAD3 

See Figure 1-13 for other values of ss. 

6. 2260 (Local) and 3270 (Local). MODE specifies the 1053, 3284, or 
3286 printer when CHUN=X'cuu' refers to a 1053 attached to a 
2848, a 3284 attached to a 3272, or a 3286 attached to a 3272, 
respectively. The operand must be entered as MCDE=X'01'. Note ; 
3270 (local) must be specified as DVCTYP=3277. 

7. 1419/1255/1259/1270/1275. MODE designates the external interrupt 
bit associated with magnetic ink character readers or optical 
reader/sorters. The mode X'Ol' - X'20' corresponds to external 
interrupt PSWs bits 26 - 31, respectively. For dual address 
adapter 1419, this parameter is needed for both 1419P and 1419S. 

X'Ol' Device attached to external line 7. 

X'02' Device attached to external line 6. 

X'04' Device attached to external line 5. 

X*08' Device attached to external line 4. 

X'lO* Device attached to external line 3. 

X'20' Device attached to external line 2. 



1018. MODE specifies whether the error-correction feature is 
present or not. 

X'OO* feature not present (default value). 
X'Ol' feature is present. 

2703. For the IBM Models 115 and 125 with the Integrated 
Communications Adapter, MODE=x'ss', MODE=X'ssss ' , or 
MODE=X' ssssss' specifies the line mode setting for a Start/Stop 
or BSC line if the TP parameter in the SUPVR macro indicates ETAM 
or QTAM teleprocessing support, or if POWER/VS is used for RJE 
applications, and the MODEL parameter in the CONFG macro 
specifies 115 or 125. If a one or two byte value is specified, 
the specified value is right- justified and padded with zeros on 
the left to fill the three bytes. Thus, to specify a single-byte 
value for a Start/Stop line that requires only one byte, you must 
supply a three-byte value, the leftmost byte of which contains 
the requested mode settings. The line mode setting and its 
default settings are discussed in Svstem/370 Model 125 Functional 
Characteristics , GA33-1506 and in System/370 Model 115 Functional 
Characteristics, GA33-1510. 
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10. 3704/370 5. MODE specifies the type of channel adapter. Wo 
default is assumed. 

X'OV Type 1 or 4 channel adapter 
X»02» Type 2 or 3 channel adapter 

If the MODE parameter is omitted or incorrectly specified, the 
assembler issues an MNOTE. 

RULES FOR USING DVCGEN 

1. A separate DVCGEN macro is required for each device. For a 2314, 2319, 3330, 33!»0, 
3350, or 3540 each individual spindle needs a DVCGEN nacro instruction. If one 
physical spindle contains two or more logical spindles, a DVCGEN macro nust be issued 
for each of these logical spindles. 

Specify 2311 if a 3330 is to be used with the 2311-1/3330 Series Compatibility 
Feature (8040): also specify 2311 if a 3340 is to be used with the 2311-1/3340 Saries 
Compatibility Series (8060); specify 2314 if a 3340 is used with the 2314/3340 Series 
Compatibility Feature (8070) ; specify 3330 if a 3350 is used with the 3330/3350 
Compatibility Feature; specify 3330B if a 3350 is used in 3330-11 compatibility 
mode. 

A separate DVCGEN macro instruction must be made for each quadrant of the 3344 (in 3340 
mode). A separate DVCGEN macro instruction must be made for each half of the 3350 (in 
3330-1 compatibility mode). 

2. The total number must not exceed the total number of devices specified in the lODEV 
parameter of the lOTAB macro. 

3. DVCGEN macros must be specified in ascending channel address sequence. 

4. Switchable units attached to more than one channel, that is 

a. Two selector channels 

b. Two block multiplexer channels, or 

c. One selector channel and one block multiplexer channel, 

must be defined only once on the lowest channel by which they are addressable. They 
cannot be redefined as nonswitchable units on the higher channel. 

5. The sequence of the DVCGEN macro instructions determines the position of the devices 
in the PUB table. SYSRES should be the first DVCGEN macro instruction if it is to 
have the highest software priority for that channel. Switchable units must be the 
last devices specified for each channel and must be on consecutive channels. 

6. The specifications of these macros can be altered at IPL by ADD and DEL statements. 

7. IBM 3210/3215 Console Printer-Keyboards that are not online but were defined by 
DVCGEN macro instructions must be deleted by DEL statements when performing IPL from 
the card reader. 

8. For Models 115 and 125 with Integrated Communication Adapter, lines are reserved as 
follows: 

X'02x' for Start/Stop 
X'OBx' for BSC, 

ASSGN 

The (ASSGN) Assiga aacro instruct ioa and xts pardaetf»rs assign sy»bolic device names 
(LUBs) to piijsical I/O devices (PUBs) . A separate macro instruction is reguired for each 
syaijoiic deirice aaae iixth a st-tiadarci system generation assxgnmeat. This macro is 
optional, however, sijice tkt? assigaaeftts can also be made after IPL- If the assignaent 
is aude at system generatioa tiae, the system uses it as a default assigasent. 
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PARAMETERS FOR ASSGN 



'"• m]W 



sysnnn,X»cuu» p, BG ~| ["» H 1 " ] SYSnnn may be any of the following system logical 

units: 

SYSRDR SYSLST SYSREC 

SYSIPT SYSLOG SYSRLE 

SYSPCH SYSLNK SYSSLB 
SYSCAT 

or a programmer logical unit (e.g. SYSOOO, SYS001) , 

If SYSnnn specifies a programmer logical unit, the range for nnn 
can be from 000 through to one less than the number of programmer 
logical units as specified in the corresponding lOTAB parameter. 

X* cuu' is the hexadecimal number of the channel and unit to 
which the symbolic device is attached. (If channel switching is 
supported, c must be the lower of two channel numbers.) A 
separate macro is required for each standard assignment desired. 

IS* ££ specifies the partition to which the assignment is being 
made; n can range from 1 to NPAETS-1. The ASSGN macro is 
ignored if a specification is entered for a partition not 
defined by the NPAETS parameter of the SOPVE macro, or not 
defined by default if the NPAETS parameter was not specified. 
If the parameter is omitted, while the next parameter is 
specified, indicate the omission by separating the last and the 
next parameters by means of two commas. 

HI or H 2 specifies the desired input hopper to be used for an 
IBM 2560 or 5U25. If both hoppers are to be used, they must be 
separately assigned to the same partition by means of two ASSGN 
macros. If the operand is omitted HI is assumed. 

Note: H2 may only be assigned to SYSRDR, SYSIPT, or SYSPCH. If 
the device is spooled by POWER/VS, SYSPCH cannot be the same 
physical device as SYSRDR/SYSIPT. If, in a particular 
partition, spooling is required from a read/punch device, a 
unique physical device address must be specified for both the 
read and the punch function (user dummy for at least one of the 
functions). For example, from a device with the physical address 
X'OOC'*,, you cannot spool both the punch and the read function- 
Making a standard foreground assignment at system generation time is equivalent to making 
a permanent assignment after IPL. When you unbatch a foreground partition, temporary 
assignments are released. 

System I/O units (SYSRDR,, SYSIPT, SYSLST, or SYSPCH) that are assigned to a tape, a 
3540 Diskette, or DASD when the system is generated are unassigned by IPL. An unassigned 
device can cause a job to be canceled. 

Notes ; 

• During system generation, conflicting assignments (ASSGN macro specifications made in 
the supervisor assembly) across partitions are not checked. 

• The device address for SYSLOG is specified explicitly by means of an attsntion 

interrupt during the IPL procedure. This causes DOS/VS to automatically assign the 
interrupting device to SYSLOG and to override the SYSLOG assignment generated in the 
supervisor. 

• Compile, link-edit, and go in a foreground partition is allowed only if a private core 
image library is supported and available. Therefore, SYSLNK must be assigned to a 
foreground partition if PCIL=YES has been specified and NPARTS>1. Note that the 
assignment can also be made at execution time. 

• At IPL time, non-operational DASD devices are indicated as being physically unavail- 
able for system operations (Device Down), tnus overriding the permanent assignment. 
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DPD 

The DPD (Define Page Data Set) macro instruction and its parameters define the page data 
set (SYSVIS) that is to hold the virtual address area. S pecification of this macro is 
optional, since t he data set can also be defined after I P L by means of the DPD command . 
It provides information about the channel and unit number of the paging device, disk 
starting address of the SYSVIS extent and the volume serial number. 

If the macro is omitted or incorrectly specified, the page data set must be defined at 

IPL time by means of the DPD command (see the DQS/VS Sys t em Management Guide). This 

command can also be used to override the information supplied by the DPD macro, until the 
next IPL. 

The IPL routines open the page data set, check its extent limits,, create label 
information for inclusion in the VTOC, and assign the symbolic name of SYSVIS to the page 
data set. 

Note ; The ASSGN statement or command cannot be used to assign or reassign SYSVIS. 

PARAMETERS FOR DPD 

DPD UNIT=X'cuu' ,CYL=nnn[,VOLID=xxxxxx] 



UNIT=X'CUU' 



CYL=nnn 



VOLID=xxxxxx 



Specify (in hexadecimal notation) the channel and unit number of the 
device that is to contain the page data set. (If UNIT is specified, 
then CYL must also be specified^ ) 

Specify the number of the cylinder where the page data set is to 
begin. The upper limit of the extent is computed by the system on 
the basis of the information supplied in the VSIZE parameter of the 
VSTAB macro. The assembler issues an MNOTE indicating the required 
number of tracks, (If CYL is specified, UNIT must also be 
specified. ) 

This parameter is optional. It specifies the volume serial number of 
the disk pack and is used for label checking. If the parameter is 
not specified in either the DPD macro or the DPD command, the volume 
serial' number is not checked. 



SENDW 

The SEND (Supervisor End) macro instruction indicates the address of the problem program 
area (PPBEG) . PFBEG is always on a 2K boundary and coincides with the address at the end 
of the supervisor (EOSSP) . Regardless of whether the SEND macro is specified with or 
without the n parameter, the generated supervisor is always fully storage-protected. 

Choose a value for n only if you want to reserve extra space within the supervisor 
area for future expansion, or for other purposes described below. If a value for n is 
selected which is larger than the size of the generated code, extra space is reserved. 
The system will not claim the extra space, not even for additional CCW translation copy 
buffers. However, if n is not specified,, any extra space is used for these buffers. If 
the space reserved is sufficient for a future expansion of the supervisor, you will 
thereby avoid having to relink-edit non-relocatable programs, link-edited for the real 
background partition. In the meantime,, you may use the extra space to expand the Problem 
Program Determination Aids (PDAIDS) area. 

If your supervisor includes the relocating loader,, no relink-editing is required for 
programs that were link-edited relocatable for a real partition. Moreover, because the 
address of the virtual background area is independent of the supervisor end address, 
expansion of the supervisor never involves relink-editing of programs that are 
link-edited for a virtual partition. 

Note ; The DOS/VS assembler requires an END and a /♦ statement following the SEND macro. 
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PARAMETERS FOR SEND 

n Specify the desired address (PPBEG) of the real address area for use by programs other 
than the supervisor. Depending on the value selected for n, the assembler takes the 
following actions: 



r T T T 

I n 1 n=niultiple | n>siz€ of | 

I specified? | of 2048 | generated | Assembler action taken 

I I I supervisor?! 

^ + ^. ^. 

I YES I YES I YES | Specif ication is accepted- 

|. ^ + + 

I YES 1 NO •] YES 1 Address specified is stepped up to next higher 

1 I I I 2K boundary. 

|. ^ + + _ 

I YES I YES I NO [Address specified replaced by generated 
I I I I supervisor end address (PPBEG). 

^ 1 ^. + 

I YES I NO 1 NO I Address specified replaced by generated 
I 1 I (supervisor end address (PPBEG). 

L f ± X 



NO 



I Address of PPBEG established on 2K boundary. 



L i X X 



Figure 1-2. Supervisor End Address Coirputation on the Basis of Different SEND ^5acro 
Specifications 
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Figure 1-3. SOPEEVISOR — Hacro Instructions Related Paraneters 
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Code 


Actual IBM Device 


Device Type 
X'nn' 


Device Type 


7770 


7770 Audio Response Unit 


D3 


Audio Response Units 


2501 t 

2540 R 

3505 

3504 


2501 Card Reader 
2540 Card Reader 
3505 Card Reader 
3504 Card Reader 


10 
11 
12 
12 


Card Readers 


2540P 

2520B2 

1442N2 

2520B3 

3525P 


2540 Card Punch 
2520B2 Card Punch 
1442N2Card Punch 
2520B3 Card Punch 
3525 Card Punch 


21 
20 
22 
20 
23 


Card Punches 


1442N1 t 
2520B1 t 
2560 t 
2596 t 
3525RP 
5425 


1442N1 Card Read Punch 

2520B1 Card Read Punch 

2560 Multifunction Card Machine 

2596 Card Read Punch 

3525 Card Punch (with optional read feature) 

5425 Multifunction Card Unit 


30 
31 
33 
30 
32 
34 


Card Read Punches 


2311 t 
2314 t 
2314 t 
2321 t 
3330* t 
3330B* 

3340' t 
3340R * t 

3340 R' t 

3340 R t 
3340* t 

3340* t 

3350* 


231 1 Disk Storage Device 

2314 Direct Access Storage Facility 

2319 Disk Storage Facility 

2321 Data Cell Drive 

3330 Disk Storage Model 1 and 2, or 3333-1 

3330 Disk Storage Model 1 1 

3340 Disk Storage (General) 

3340 Disk Storage with RPS feature (with or without 

3340 Data Module, Model 35) 
3340 Disk Storage with RPS feature (with or without 

3340 Data Module, Model 70) 
3344 Direct Access Storage 
3340 Disk Storage without RPS feature (with or without 

3340 Data Module, Model 35) 
3340 Disk Storage without RPS feature (with or without 

3340 Data Module, Model 70) 
3350 Direct Access Storage 


60 
62 
62 
61 
63 
65 
6A 
69 

6A 

69 
6A 
67 


DASD 


3540 t 


3540 Diskette Input/Output Unit 


80 


Diskette Storage Device 


2955 


2955 Data Adapter Unit 


D7 


Data Link for RETAIN 


125D 
125DP 

3277 


Model 115 or Model 125 Integrated Display Operator Console 
Model 138/148 console in 115/125 console display 

emulation mode 
Model 115 or Model 125 Integrated Display Operator Console 

with 5213 Console printer attached 
3286-2 in display mode 

Note: Codes are valid for native Alpha-Nunneric Replacement (ANf^l 
mode and for 1052 emulation mode. The 1052 mode is not 
supported with Indirect Data Addressing (IDA). 

3277 Operator Console 


B2 
82 

BO 


Display Operator Console 


2260 

3277 (Local 3270) 

3277B (Local 32701 


2260 Display Station 

3277 Display Station; MODE operand need not be entered 
3277 Display Station; attached in Burst Mode to a multi- 
plexer channel. MODE operand need not be entered 
Note: A 3277, In order to be used as a display operator console, must 
not be assigned to the same selector or nriultlplexer channel as SYSRES. 


CO 
BO 

BO 


Display Stations 


2400T9 t 
2400T7 t 


9-track Magnetic Tape Units 2400 • series 
7-track Magnetic Tape Units 2400 - series 


50 
50 


Magnetic Tape Devices 


Specify 231 1 if a 3330-1 is used with the 2311-1 /3330 Series Compatibility Feature (8040). 

Specify 231 1 if a 3340 is used with the 231 1-1 /3340 Series Compatibility Feature (8060). 

Specify 2314 if a 3340 is used with the 2314/3340 Series Compatibility Feature (80701. 

Specify 3330 if a 3350 is used in 3330 compatibility mode. 

Specify 3330B if a 3350 is used in 3330-11 compatibility mode. 

t indicates burst-mode devices or overrunable devices that require specification of BMPX=YES in the PIO macro. 
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Code 


Actual IBM Devie« 


Device Type 
X'nn' 


Device Type 


3410T9 + 
34tOT7 t 
3420T9 + 
3420T7 t 


9-track 3410 Magnetic Tape Units 
7track 3410 Magnetic Tape Units 
9-track 3420 Magnetic Tape Units 
7tracfc 3420 Magnetic Tape Units 


53 
S3 
52 
52 


Magnetic Tape Devices 


1419 + 
1419 + 
1419 + 
1419P + 
1419S + 


1255 Magnetic Character Reader 

1259 Magnetic Character Reader 

1419 Magnetic Character Reader 

1419 Dual Address Adapter Primary Control Unit 

1419 Dual Address Adapter Secondary Control Unit 


72 
72 
72 
73 
74 


MICR - Magnetic Ink Character Recognition Device* 


3895 


3895 Document Reader /I nscriber 


7D 


Header /I nscriber 


1419 t 
1419P + 
1419S + 

1287 + 

1288 + 
3881 

3886 


1 270 Optical Reader Sorter 

1275 Optical Reader Sorter Primary Control Unit 

1275 Optical Reader Sorter Secondary Control Unit 

1287 Optical Reader 

1288 Optical Page Reader 
3881 Optical Mark Reader 
3886 Optical Character Reader 


72 
73 
74 
77 
77 
11 
7C 


Optical Readers 


1018 


1018 Paper Tape Punch with 2826 Control Unit Model 1 


79 


Paper Tape Punches 


1017 
2671 


1 01 7 Paper Tape Reader with 2826 Control Unit Model 1 
2671 Paper Tape Reader 


78 
70 


Paper Tape Readers 


PRT1 

1403 

1403U 

1443 

2245 

2260 (Local) 

3203 
3211 
3277 (Local 3270) 

3277B (Local 3270) + 

3800 
3800B 

3800C 

3800BC 

5203 
5203U 


3211 or 3203-4 Printer 

1403 Printer 

1403 Printer with UCS feature 

1443 Printer 

2245 Kanji Printer 

1053 Printer with 2848 Control Unit, MODE operand 

most be entered as X'OT 
3203 Printer Model 1 and 2 
3211 or 3203 4 Printer 
3284 or 3286 Printer with 3272 Control Unit, MODE 

operand must be entered as X'Ol' 
3284 or 3286 Printer with 3272 Control Unit, attached in 

Burst Mode to a multiplexer channel. MODE operand 

must be entered as X'OV 
3800 Printing Subsystem 

3800 Printing Subsystem with optional Burster-Trimmer- 
Stacker 
3800 Printing Subsystem with additional character 

generation storage 
3800 Printing Subsystem with Burster-Trimmer-Slacker 

and additional character generation storage 
5203 Printer 
5203 Printer with UCS feature 


43 
40 
42 
41 
44 
CO 

4A 
43 
BO 

BO 

45 
45 

45 

45 

4C 
4D 


Printers 


1050 A* 


3210, 3215 Console Printer Keyboards 
3286-2 in printer keyboard mode 


00 


Printer Keyboard 


2495TC 


2495 Tape Cartridge Reader 


51 


Tape Cartridge Reader 


2701 
2701 

2701 h 

2703 
3705 
3791 L 


2701 /271 5 Data Adapter Unit 

Model 135 Integrated Communicatkin Adapter (ICA) 

2702 Transmission Control Unit 

Model 1 15 or 125 Integrated Communicatk>n Adapter 
3704/3705 Communications Controller 
3791 Local Communicatk>ns Controller 


DO 
00 

Dl 

02 
DC 
DE 


Teleprocessing lines 

A'SADO command wlwn enabling ttte line 
B^SADI command when enabling the tine 
C=SAD2 command w»»n enabling the line 
D=SAD3 command when enabling the line 


2703 
2703 


3704/3705 Communications Controller in Emulation Mode 
2703 Transmission Control Unit 


02 
02 




UNSP 

UNSPB + 


Unsupported Device 
Unsupported Device 


FF 
FF 


Unsupported no-burst mode on multiplexer channel 
Unsupported with burst mode on multiplexer channel 


•Not«: Sp^ify oodi of 125Dor 1250Pfor a »*xlel 115 or Modal 135 Imagmsd Oitplty Op«r«ior Coniola in 1052 •mulalion modt 
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Supervisor Real Storage Requirements 

This section contains the data for estimating the size of the supervisor required for a 
generated system,, that is, the amount of real storage needed at object time for tne 
supervisor macro instructions. 

The supervisor varies in size from system to system depending on the user-selected 
options and the machine configuration. All supervisor generation options are described 
earlier in this module under "The Supervisor Generation Macros". 

The size of the supervisor is a determining factor for the amount of real storage 
available for problem program use. All real storage not allocated to the supervisor is 
available for use by programs running in virtual mode (the main page pool) and in real 
mode via specification of real partitions. For more details on the allocation of real 
partitions refer to the description of the ALLOCR macro instruction. 

Figure 1-5 gives the real storage requirements for your supervisor, the size of vjhich 
is determined by the options you specify (including default specifications) in the 
supervisor generation macro instructions. The basic supervisor (see sizes on the first 
line of data of Figure 1-5) is dependent on the number cf partitions you require (SUPVR 
macro NPARTS=); however, it is independent of any other supervisor generation options. 

To this basic size you must add the storage requirements for each selected option (see 
column "Generation Operand" in Figure 1-5). You must be careful to include the values 
for any options you have selected by default. 

You must also include the storage requirements for any option you did not specify but 
which is forced by another option you did specify (see Figure 1-3 showing which options 
are forced or required). Thus, for example, the SUPVR macro operand for Page Exception 
Handling Overlap (PHO=YES) forces the FOPT iracrc operand PFIX=YES for page fixing. 
Therefore, if you specify PHO=YES, you must include the storage requirements of both 
PHO=YES and PFIX=YES. 

The comments column of Figure 1-5 indicates when one option forces another option or 
is forced by another option. Certain options share common code and thus the mixture 
rather than the individual values must be considered in obtaining the total storage 
requirement. Thus, for example,, the FOPT macro options IT=YES, PC=YES, and OC=YES share 
common code. Figure 1-5 provides for this by stating storage requirements for each 
option separately and in all combinations. If you have selected more than one of these 
options, select the combined requirement from the row which includes your combination. 

The SEND macro instruction allows you to reserve additional storage for your 
supervisor. Refer to the description of the SEND macro instruction for further details. 

Because of storage protection, the supervisor must always end on a 2K storage 
boundary. Supervisor generation always causes the total generated supervisor size to be 
rounded up to the nearest 2K boundary- Thus, a calculated supervisor end address of, 
say, 31,120 bytes, is rounded to 32K (32,768 bytes) . 

Some supervisor macro instructions do not affect your storage requirements because 
they merely supply information to be placed in storage occupied by other macro 
instructions. These macro instructions are not included in Figure 1-5. They are: 

STDJC (all operands except SPARM=YES) 

ALLOC 

ALLOCR 

DVCGEN 

ASSGN 

DPD 
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In suniirary, to calculate the size of your supervisor, add the values as indicated in 
Figure 1-5 for: 

• your base {determined by NPARTS=) 

• The storage requirements for all options you specifically selected 

• The storage requirements for those options you did not specify but that default to YES 

• storage requirements for all options you selected indirectly, that is options that 
were forced by other, specified, options 

• Any additional storage you reserved via the SEND macro instruction. 

• For any combination of options not explicitly shown in Figure 1-5, you should add up 
the individual values. 





Generation 


NPARTS=1 




MultipfO{ 


ramming 




Comments 


Supervfsor Element 


Operand 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


SUPVR (Required Rout- 




23960 


29944 


30488 


31064 


31672 


Based on MODEL=115or MODEL=126 


ines — Basic Size) 
















SVC Interruption Handling 
















Svstem Loader (FETCH and LOAD) 
















Minimum t/0 Units Control Tables 
















(LUBs, PUBs, andJIBs) 
















General Entry and Exit Routines 
















System Communication Region 
















Partition Communication Regions 
















Transient Areas 
















End of Job Stsp 
















Byte Multiplexer and Selector Channel Support 
















Storage Protection 
















CCW Translation 
















Page Management 
















231 1/2314 Disk Error Recovery 
















QEtjonaljUiutinei 
















Multitasking 


AP=YES 


NA 


4680 


4442 


4216 


4000 


1, Forces WAITM=YES 

2. Forces NPARTS=3 if NPARTS omitted 


ASCII/EBCDIC Translation Tables 


ASCII=YES 


512 


512 


512 


512 


512 


or specified as 1 


RMSRsupport for Channel-attached 


CHAN=YeS 


960 


1024 


1024 


1024 


1024 


If RUS=YESor MCH^YES is also specified, add 


devices, tape units, or TP-devices used 














the value given for RMS instead. 


with a Model 115 or 126 
















Reliability Data Extractor Error 


ERRLOG=RDE 

















For Model nSor 125, CHAN=VESor RMS=VES 


Recording (IPL.EOD) 














is rvquind 


14xx Emulators 


eU=YES 


216 


216 


216 


216 


216 




Supervisor Select 


ID = c 



















Model 115/125 MCAR/CCH support 


MCH = YES 


3968 


3968 


3968 


3968 


3968 


If RMS^YES or CHAN=^YES is also specified, add 
the value given for RMS instead. 


Magnetic Ink Character Reader 


M(CR = 1419 


1206 


1208 


1208 


1208 


1208 




Page Exception handling 


(for 1255/ 1259 /1 270 /1 276s 
see Note 1 ) 
















MICR = 1419D 


1080 


1080 


1080 


1080 


1080 






( Dual Address Adapter 
















1419/127E«) 














Page Handling 


PAGE IN=n(n must be *1) 


1408 -t- 
8n 


1592 -t- 
8n 


1592 + 
8n 


1592+ 
8n 


1592 + 
8n 




Page Exception Handling Overlap 


PHO = YES 


592 


640 


656 


680 


696 


Forces PFIX=Y£S; Forced by POWeR=YES 


POWER/VS 


POWER = YES 


NA 


546 


546 


546 


546 


Forces NPARTS=3, if NPARTS omitted 
or specified as 1; also forces PHO=YES, 
PFIX=YES, and ECPREAL=YES 


RMS support ( RMSR plus MCA/CCH ) 


RMS=YES or CHAN=YES and 


4864 


4928 


4928 


4928 


4928 


Do not include any values for CHAN=YES 


for Model 115 and 125 


MCH=YES 












and for MCH=YES 


Teleprocessing 


TP=BTAM 


544 


872 


872 


872 


872 


TP=QTAM Of VTAM forces NPARTS=3 


(see Note 2) 


TP=aTAM 


NA 


1400 


1400 


1400 


1400 


if NPARTS is omitted or specified as 1 




TP=QTAMn 


NA 


1352 


1352 


1352 


1352 


















TP'VTAM forces AB=YES, ECPREAL=YE$, 




TP=VTAM 


NA 


3020 


3012 


3004 


2996 


GETVIS=YES, IT»VES, OC=YES, PC=YES, 




TP=(BTAM,VTAM) 


NA 


3020 


3012 


3004 


2996 


PFIX=YES, RELLDR'YES, RMS=YES in the 




TP=(QTAM,VTAM) 


NA 


3580 


3572 


3564 


3556 


case of Models 1 15 and 126, and TOD^YES. 




TP={aTAMn,VTAM) 


NA 


3532 


3524 


.3516 


3508 


AP=YES is required. 
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Supervisor Element 


Generation Operand 


Multiprogramming 




NPARTS=1 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


CONFG 












• 




(Configuration Options} 
















Floating Point Feature 


FP=YES 





72 


72 


72 


72 




Model 115 
Model 125 


MODEL=115 
MODEL=125 


1 
/ Log out area = 






■v 


Model 1 35 
Model! 38 


MODEL=135 
MODEL=138 


? Log out area = 120 






I Forces RMS support (see 


Model 145 
Model 148 


MODEL=145 
MODEL=148 


/ Log out area = 672 






I RMS=YES in SUPVR macro) 


Model 155-11 
Model 1 58 


MODEL=155-ll 
MODEL=158 


,■ Log out area = 992 






J 


STDJC 














(Standard Job Control 
















Settings) 
















Support of &SYSPARM 


SPARM-YES 


8 


16 


24 


32 


40 


other STDJC options require no storage 


Assembler System 
















Variable Symbol 
















FOPT 














(Functional Supervisor 
















Options) 
















Abnormal Termination 


AB=YES 

without AP=YES 


288 


296 


304 


312 


320 


Forced by VSAM=YES 




with AP=YES 


NA 


384 


384 


384 


384 




Console Buffering 


CBF=n (see Note 5} 




240 + 104n 






Does not apply to Models 115 and 125, 
138, 148 


DASO 


DASDFP={n1,n2) 




336+24(n2-n1) 








File 


for 2311/2314 












Protection 


DASDFP=(n1,n2) 
for 2311/2314, 33xx 

DASDFP={n1,n2,2321) 
for 231 1/231 4, 
33xx, 2321 




400 + 24(n2-n1) 
464 + 24(n2-n1) 








Display 
Operator 


DOC=1250 
DOC=3277 


3392 
4864 


3392 
4864 


3392 
4864 


3392 
4864 


3392 
4864 




Console 
















Error Queuing 


ERRQ=n 


44(n-3) 


44(n-5| 


44(n-5) 


44(n-5) 


44(n-5) 


if default used 


Error Volume Analysis 


EVA=(r,w) 

















Forces TAPE=7 


Fast CCW 
translation 


FASTTR=YES 
FASTTR=YES 
when AP=YES 


2120 

NA 


1992 
2296 


2024 
2296 


2048 
2296 


2080 
2296 


Does not include buffer space 
(seeBUFSIZE) 


Virtual Storage 
Management Support 


GETV1S=YES 


1126 


1318 


1318 


1318 


1318 


Forced by VSAM=YES, and RPS=YES 
Forces RELLDR=YES 


Independent Directory 
Read/In Area 


!DRA=YES 


NA 


200 


200 


200 


200 


Valid only if NPARTS>1 (Add 768 byte 
if RELLDR=YES) 


Interval Timer 


IT=YES 


432 


880 


888 


912 


920 


If OC=YES, refer to OC, if PC=YES, 
refer to PC 


Job Accounting 


JA=YES 


488 


672 


808 


944 


1080 




Interface 


JA=(n1,n2,n3,n4,n5) 


576 + 
8(n1} 


760 + 

8(n1+n2) 


896 + 
8(n1+n2+n3) 


1032 + 

8(n1+n2+ 
n3+n4) 


1168 + 

8{n1+n2+ 

n3+n4+n5) 






JALIOCS=(s,l} 




Value from JA plus 


(s + l) -16 








(see Note 3) 
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Supervisor Element 


Generation Operand 


NPARTS=1 


Multiprogramming 


Comments 


NPARTS=2 


NPARTS=3 


NPART$=4 


NPARTS=5 


FOPT Icorrtinued) 
















User Channel Program 


ECPREAL=YES 


320 


320 


320 


320 


320 


Forces PFIX'YES; 


Translation 














Forced by PQWER=YES 


Problem Program Handling 


OC=YES 


280 


288 


296 


304 


312 


Forced by RETAIN=YES 


of External Interruptions 














and OLTEP=YES 




Including IT=YES 


572 


968 


984 


1016 


1032 






Including IT=YES when 


NA 


1232 


1240 


1248 


1256 


Does not include any AP storage 




AP=YES 












requirements 




Including IT=YES and 


560 


1016 


1040 


1064 


1088 






PC=YES 
















Including IT=YES and 


NA 


1408 


1416 


1424 


1432 


Does not include any AP storage 




PC=YESwhen AP=YES 












requirements 


Online Testing 


OLTEP=YES (default) 


248 


256 


256 


256 


256 


Forces RELLOR=YES and OC=YES 
Forced by RETAIN-YES 


Support of User Program 


PC=YES 


248 


264 


272 


280 


288 




Check Routines 


















when AP=YES 


NA 


384 


384 


384 


384 


Does not include any AP storage 
requirements 




Including IT=YES 


480 


944 


952 


992 


1008 






Including OC=YES 


328 


352 


368 


384 


400 






Including IT=YESwhen 


NA 


1312 


1312 


1312 


1312 


Does not include any AP storage 




AP=YES 












requirements 




Including IT=YES and 


NA 


1408 


1416 


1424 


1432 


Does not include any AP storage 




OC=YESwhen AP=YES 












requirements 


Private Core Image Library 


PCI L= YES 


192 


224 


240 


264 


280 




Support 
















Problem Determination 


PD=n 


n + 160 


n + 200 


n + 200 


n+200 


n + 200 




Program (PDAIDSI 


















PD=YES 


1560 


1600 


1600 


1600 


1600 




Page fixing 


PFIX=YES 


1776 


1928 


1928 


1928 


1928 


Forced by PHO=YES, ECPREAL-YES 














and POWER=YES 




PFIX=YESand FASTTR=YES 


1984 


2136 


2136 


2136 


2136 




Partition Dispatctiing 


PRTY=partition name and sequence 


NA 
















Priority 
















Private Second 


PSLD=n 


8n 


16n 


24n 


32n 


40n 




Level Directories 
















Relocating Loader 


RELLDR=YES 


448 


448 


448 


448 


448 


Forced by GETVfS--YES, OLTEP-YES, 
VSAIVI=YES, and RPS--YES 








112 


112 


112 


112 


Forces OC=YES and OLTEP=YES 


RETAIN-Remote Initiation 


RETAIN=YES 


112 






of OLTEP programs 
















Rotational 


RPS=YES 


NA 


600 


600 


600 


600 


Forces GETVIS=YeS, 

RELLDR -YES, and BLKMPX=YES 


Position Sensing 
















Seek Separation 


SKSEP=YES, or n (see Note 4) 


150 + 5n 


150 + 5n 


150 + 5n 


160 + 5n 


150 + 5n 




Second Level Directory 


SLD=n 


8n 


8n 


8n 


8n 


8n 




Disk System Input and 


SYSFIL=YESorYES(n1,n2) 


704 


720 


876 


962 


1048 




Output Files 


and DASDFP=NO 
















and DASDFP=(k1,k2,2321) 


1088 + 24(k 


2-k1)+86(N 


PARTS-1) 










and DASDFP=(k1.k2) 


960 + 24(k2 


-k1) +86(NP 


ARTS-1) 










and DISK=(231 1,2314) 
















andDASDFP=(k1,k2) 


1040 + 24(l< 


2-k1) +86(N 


PARTS-1) 










and DISK=(23n,2314,33xx) 
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Supervisor Elerrtent 


Generation 




Multiprogramming 


Comments 




Operand 


NPARTS=1 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 






FOPT (Cont.l 


















Tape Error Statistics — 


TEB=n 


36+6n 


36-H6n 


36-t-6n 


36+6n 


36+6n 






2495 Tape Cartridge 


















Reader 


















Tape Error Statistics 


TEBV=IR, orCR 





















by Volume 


















Time-of-Day Clock 


TOD=YES 


640 


640 


640 


640 


640 






Support 


















Track Hold 


TRKHLD=n 


NA 


464+ 


464+ 


464+ 


464+ 


Valid only if NPARTS>1 






(see Note 6) 




12n 


12n 


12n 


12n 






Supervisor identification 


USERID=id 

















Included in basic size whether id is specified 


or not. 


VSAM 


VSAM=YES 
(incl.NRES=10) 


1752 


984 


984 


984 


984 


Forces AB=YES, GETVIS=YES, NRES=10, 
and RELLDR=YES 




Multiple Wait 


WAITM=YES 


56 


56 


56 


56 


56 


Forced by AP=YES 




Cross- partition 


XECB=YES 


NA 


884 


948 


1012 


1076 






Communication 


XECB=n 


NA 


756-H6n 


756+1 6n 


756+16n 


756+1 6n 






Time Zone for Time of 


ZONE=NO ■ 
















Day Clock Support 


{EAST,hh,mm) 
(WEST,hh,mm) 





















Task Timer 


TTIME=YES 
and AP=NO 


390 


390 


390 


390 


390 








TTIME=YES 


400 


400 


400 


400 


400 








and AP=YES 
















Synchronous Exit 


SYNCH=YES 


252 


252 


252 


252 


252 


Forced by RPS=YES 




PIOCS 


BLKMPX=YES 


32 


32 


32 


32 


32 


(Physical IOCS Support) 


















Burst Mode on Byte 


BMPX=YES 


80 


80 


80 


80 


80 






Multiplexer Channel 


















Channel Switching Tape 


CHANSW=RWTAU 


224 


224 


224 


224 


224 


Forces TAPE=7 




Control 


or TSWTCH 


















DISK=2311,or2314 

















Not valid if M0DEL=1 15 or 125 






DISK=3330 


768 


768 


768 


768 


768 


Forced for Model 125 






DISK=3340 


1344 


1344 


1344 


1344 


1344 


Forced for lyiodel 115 






DISK=3350 


832 


832 


832 


832 


832 


Not valid If M0DEL=11 5 or 1 25 






DISK=(3330, 


1600 


1600 


1600 


1600 


1600 








3340) 


















DISK=(3330, 


896 


896 


896 


896 


896 








3350) 


















DISK=(3340, 


1600 


1600 


1600 


1600 


1600 








3350) 


















DISK={33.30, 


1664 


1664 


1664 


1664 


1664 








3340, 


















3350) 
















MICR Device on Selector 


MRSLCH=YES 


32 


32 


32 


32 


32 






Channal (1419 Single 


















Address,Device only) 














TAPE=7 is forced by EVA=(r,w) and 




Tape Support 


TAPE=7, 

or 9 (default) 


584 


584 


584 


584 


584 


by CHANSW=RWTAU or TSWTCH. For Model 115 
or 125 CHAN=YES is required. 


VSTAB 




1 
Obtain value from table - 


This is fo 
NPARTS 




(Size of Real and Vir- 
tual Address Areas and 
CCW Translation 


RSIZE=n,K — 1 


Part 5 of this Figure. 
_^ When PHO=YES or 

PFIX=YES,addY-, and 


r: 

=1 652 
2 788 






space) 


VSIZE=n2K —J 




3 856 








(See Note 8) 


subtract the number of bytes 




4 924 








BUFSIZE=n 


included in basic supervisor. 




5 992 








(Required) 




















72(n-10) 


72(n-30) 


72(n-30) 


72(n-30) 


72(n-30) 


if default used (for FASTTR^NO). 
If FASTTR=YES, substitute for 'n' 






SVA=(ftk,mk) 

















the specified or default value. 
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d 
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Figure 1-5. Supervisor Real Storage Requirements — Bytes (Part 6 of 6) 



Notes : 



A 1255/1259/1270 
MICR=1«*19. 



is addressed as a single address adapter machine* that is^ 



NPARTSM Is required for TP=QTAMn. TP=QTAMn includes BTAM supervisor support, if 
AP=TfEr> when TP=QTAMn, then the quantity A must be added to the basic storage 
requirement for TP=QTAMn. A=4U+(n-2) 12, where n is the value elected for TP=QTAMn. 

(For multitasking, AP must equal T^ES.) 

If s is omitted or if its specification is invalid, then 16 bytes are reserved. If 
is omitted or if it is invalid, is assumed. 

When SKSEP=YES, n (in the formula) equals the number of DASD devices specified at 
system generation time. When SKSEP=n, n (in the formula) is the number of DASD 
devices supported as specified^ but cannot be less than the number specified at 
system generation time. 
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5. The selection of the CBP option results in extra channel queue usage. Consider this 
when requesting the number of CHANQ entries. Thus, specification of the CBF option 
and selection of the CHANC default, results in the nuirber of buffers specified being 
added to the CHANQ default, for which see below. 

CHANQ default = 6 if NPARTS=3 
CHANQ default = 8 if NPARTS=a 
CHANQ default = 10 if NPARTS=5 

Only if the number of queue entries as specified by the CBF parameter plus the chanq 
default is larger than the number of entries actually specified by the CHANQ 
parameter, add 8na, where n3=CHANQ default ♦ CBF specification - CHANQ specification 
(zero for negative)*. 

Example 1: CHANQ=30 
CBF=a 
NPARTS=4 (CHANQ default is 8) 

Number of bytes reserved for CBF: 2^0+104x4+8x0 (n2=0 because CBF(4)+chanc default (8) 
is less than 30 (CHANQ specification). 

Example 2: CHANQ=10 
CBF=U 
NPARTS=4 (CHANQ default is 8) 

Number of bytes reserved for CBF: 240+104x4+8x2 (na=2 because CBF( 4) +CHANQ default (8) 
minus CHANQ (10) =2). 

6. Where n equals the maximum number of tracks (1-255) tc be held at any given time by 
the entire system. The default is 10 if n is an invalid parameter (non-numeric or 
outside the range, 1-255). 

7. In addition to the total number 6f bytes reserved for the devices specified, an 
extra amount is reserved of 12B bytes, where B equals the number of devices 
specified by the lODEV parameter minus the total number of devices specified by the 
Oxxxx parameters. (B=n-(n, +03 +n3 +04 +ns +n6 +n7 +ng +0, + njo + n,, + nn)- 

The minimum value of B is 5, because of the fact that if the total nuirber of devices 
specified by the Dxxxx parameters exceeds the number of devices specified by the 
lODEV t>arameter, the latter number is upgraded to 5 more (for unit record devices) 
than the number of devices specified by the Dxxxx parameters. 

8. Since the table (Part 5 of this figure) does not contain all possible VSIZE values, 
you say ase the nearest larger value without significant error. The, exact formula 
for calculating real storage reguiresents is as follows, where n1=fisiZE specification 
and n2«VSZZE specification, both in K bytes. 

4 X n1 + 68 X CEIL ♦ 64 x CEIL ♦ value 

If n1>384, **value** eguals 148, otherwise "value** equals 0. 
For CEIL substitute the guotient of 

Pi ♦ p2 ; fractions are to be rounded off to the next higher integer. 
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Computing the Size of a Supervisor 



As an example^ assiame a supervisor is generated using the macros shown 
in Figure 1-6. The size of this supervisor is determined as follows: 

GENERATION OPERAND REAL STORAGE 

REQUIREMENT (bytes) 

SUPVR 

NPARTS=4 , 29,056 

POWER=YES U62 

PHO=YES , 680 

TP=BTAM, , , 872 

CONFG 

MODEL=135, , 5, 072 

FP=YES 72 

STDJC 

FOPT 

RELLDR=YES 448 

VSAM=YES. 984 

IT=YES 

OC=YES . 1,096 

PC=YES 

SKSEP=YES 160 

PCIL=YES. .- ,- 2 64 

PFIX=YES 1,928 

CBF=10 1,280 

TRKHLD=10,.-- 584 

SYSFIL=YES 

DASDFP=(1„ 1,3330) -■ 1,2 96 

TOD=YES , 640 

ZONE=(WEST, 5) 

GETVIS=YES 1,144 

OLTEP=YES 256 

AB=YES 448 

ECPREAL=YES 320 

PIOCS 

DISK=3330 760 

TAPE=7 , 584 

VSTAB 

RSIZE=24 0K, ,. 1,2 40 

VSIZE=702K 

BUFSIZE=48 1,296 

SVA=(302K,0K) 

ALLOC 

ALLOCR 

lOTAB 

BGPGR=20 20 

F1PGR=10 10 

F2PGR=10 .,, 10 

. F3PGR=10 , , 10 

I I0DEV=15. , 158 

JIB=45 , 160 

ID3330=2 64 
D3410=4 336 

CHANQ=32 19 2 

NRES=10 ,., (included in VSAW) 



I 



Total Number of Bytes , 51,902 

Note ; If entry for BGPGR is below minimum requirement, n=10 is assumed. The following 
MNOTE is obtained for an entry of less than 10. 

BGPGR SPECIFICATION BELOW MINIMUM - "10" ASSUMED 
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// JOB SUPVR 

// OPTION DECK 

// EXEC ASSEMBLY) ^^^ ^^^ ^^^^^ 

MACRO f 

GENSUPVR 

SUPVR NPARTS=4, POWER=YES, PHO=YES„TP=BTAM 

CONFG MODEL=135,FP=YES 

STD JC LI STX= YES , LI NES=4 6 , EDECK=YES 

FOPT RELLDR=YES,IT=YES,VSAM=YES,OC=YES,PC=YES, 

SKSEP=YES,PCIL=YES„CBF=10,TRKHLD=10,SYSFIL=YES, 

DASDFP=(1,3, 3330),TOD=YES,ZONE={WEST,5) ,PFIX=YES, 

AB=YES,OLTEP=YES,ECPREAL=YES 
PIOCS DISK=3 330,TAPE=7 

VSTAB RSIZE=2UtlK,VSIZE=702K,BUFSIZE=48,SVA= (302K,0K) 
ALLOC F1=128K,F2=64K,F3=128K 
ALLOCR BGR-60K,F1R=30K,F2R=30K 
lOTAB BGPGR=2 0,F1PGR=10,F2PGR=10,F3PGR=10,IODEV=15,JIB=U5, 

CHANQ=3 2,D3330 = 2,D3U10=tl,NRES=10 
DVCGEN CHUN=X'OOC'' DVCTYP=25llOR 



END 
/* 



DVCGEN CHUN=X'OOD" 
DVCGEN CHUN=X'OOE' 
DVCGEN CHUN=X'01F' 
DVCGEN CHUN=X'020' 
DVCGEN CHUN=X'0 21' 
DVCGEN CHUN=X'022' 
DVCGEN CHUN=X'0 23' 
DVCGEN CHUN=X'024' 
DVCGEN CHUN=X'160" 
DVCGEN CHUN=X'161' 
DVCGEN CHUN=X'280' 
DVCGEN CHUN=X'281' 
DVCGEN CHUN=X'28 2* 
DVCGEN CHUN=X'28 3' 
ASSGN SYSRDR,X'OOC 
ASSGN SYSIPT,X'OOC 
ASSGN SYSPCH,X'OOD 
ASSGN SYSLST,X'OOE 
ASSGN SYSLOG.X'OIF 
ASSGN SYSLNK,X'160 
ASSGN SYS001,X'160 
ASSGN SYS0 02,X'160 
ASSGN SYS003,X*lbO 
ASSGN SYSREC,X'160 
ASSGN SY SCAT, X' 161 
DPD CYL=200,UNIT=X 
SEND 
MEND 
GENSUPVR 



DVCTYP = 2 5tlOP 

DVCTYP=3211 

DVCTYP=1050A 

DVCTYF=2703 

DVCTYP=2703 

DVCTYP=2703 

DVCTYP=2703 

DVCTYP=2703 

DVCTYP=3 330 

DVCTYP=3330 

DVCTYP=3mOT7 

DVCTYP=3U10T7 

DVCTYP=3410T9 

DVCTYP=3 410T9 



160' ,VOLID=SYSRES 



I see Note, below 



Note: For MACBO, GENSUPVR, and MEND, refer to "Automatic Docunentation of Supervisor 
Generation Macros". 

Figure 1-6. SUPERVISOR — Example for Coirputing the Size of a Supervisor 



Planning an Operational Pack 

An operational system is one used in day-to-day operations and contains one or more 
tailored supervisors, and libraries appropriate to each customer's particular combination 
of system programs and application programs. A system maintenance volume is one used 
primarily to facilitate changes to programs supplied by IBM. Application programs can 
also be added to a maintenance volume for ease of program maintenance. Change 
Distributions are those changes supplied by IBM to the IB^.-shipped volume. 
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Proper planning is the key to successful system generations. The tiire spent in 
planning can save you frustration and valuable time. Planning should reflect the 
initial, intermediate and ultimate capacity of the core image, rej.ocatable, source 
statement, and procedure libraries. Enough work file capacity must be available 
throughout system generation for assemblies and link- edit steps. 

The module for each component should be used to determine its storage requirements. 
Figure 1-18 contains a summary of the library and partition requiremients for all 
components shipped with DOS/VS. Adjust the requirements you derived from this figure for 
any program products (separately purchased components) you are including. Please also 
note that any licensed programs supplied in A-macro format must be edited. 

The IBM-supplied system contains seven preassembled and cataloged supervisors for the 
231^/2319, 3330, 3340, and 3350 resident systems. The supervisor $$A$SUP1 is described 
in "Supervisor Nucleus — 5745-50 -SUP". 

S TORAGE REQUIREJyiENTS FOR IBM-SUPPLIED DOS/VS PROGRAMS 

Note that the partition save area is located at the beginning of each partition, thus 
reducing the partition size by the length of the save area. 

Organization of a DOS/VS System Pack 

The organization of the system pack is as follows: 



Name 

I PL Program 

System Volume Label 

System Directory 

Core Image Directory 

Core Image Library 

Relocatable Directory, Optional 

Relocatable Library, Optional 



Source Statement Directory, 
Optional 

Source Statement Library, 
Optional 

Procedure Directory, Optional 



Procedure Library, Optional 



Label Information Cylinder(s) 



St art of Location 

Track of cylinder 0. 

Track of cylinder 0. 

Track 1 of cylinder 0. 

Track 2 of cylinder 0. 

Beginning of the first available track following the 
core image directory. 

Track of the first available cylinder following the 
core image library. 

Beginning of the first available track following the 
relocatable directory. 

Track of the first available cylinder following 
the previous library. 

Beginning of the first available track following the 
source statement directory. 

Track of the first available cylinder following the 
previous library. 

Beginning of the first available track following the 
procedure directory. 

First full cylinder (plus a second cylinder for the 
3340) after the last system library. 
Figure 1-7 shoirs the DOS/VS concept of label track 
allocation, using the 2314/2319 as an example. 



Volume Table of Contents 



Location assigned by the user. 
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Note ; The IPL procedure cannot be perforined if part of the Supervisor Nucleus in the 
core image library is located on an alternate track. 



Track 



T 1 

Background User 

Labels 



I— + 



Background User 
Labels 



■+- 



Background User 
Labels 



Background User 
Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



H-+ 



Foreground 1 
User Labels 



Foreground 2 
User Labels 



Foreground 3 
User Labels 



Foreground 4 
User Labels 



H- + 



-+- 



Foreground 1 
Partition Stan- 
dard Labels 



I— + 



Foreground 2 
Partition Stan- 
dard Labels 



Foreground 3 
Partition Stan- 
dard Labels 



Foreground U 
Partition Stan- 
dard Labels 



■+- 



-+■ 



Standard 
Labels 



10 



19 

L L 



Foreground 1 
User Labels 



Foreground 2 
User Labels 



Foreground 3 
User Labels 



Foreground 1 
Partition Stan- 
dard Labels 



Foreground 2 
Partition Stan- 
dard Labels 



Foreground 3 
Partition Stan- 
dard Labels 



■+- 



Foreground 1 
User Labels 



Foreground 2 
User Labels 



Foreground 1 
Partition Stan- 
dard Labels 



-+- 



Foreground 2 
Partition Stan- 
dard Labels 



-+- 



Foreground 1 
User Labels 



Standard 
Labels 



Foreground 1 
Partition Stan- 
dard Labels 



Standard 
Labels 



Standard 
Labels 



2-Partition 
Systeir 



3-Partition 

System 



4-Partiticn 

System 



5-Partition 
System 



Figure 1-7. Label Cylinder Track Allocations for 2314/2319 Disk-Resident Systems 

Allocating Library Sizes 



when the size of an existing library is reduced, it may ce important to know the minimum 
size library that can be allocated. Once the minimum size library is calculated, it 
should be increased to accommodate any problem programs to be included in the library. 
The size of IE^5 components can be determined by referring to the storage requirements 
given in Figure 1-18 and to appropriate documentation for any licensed programs to be 
included. 
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The following explanation illustrates how to calculate the number of tracks required 
for a core image, relocatable, source statement, or procedure library. The formula for 
computing the size of a library is: 

Library (size in tracks) = LBA/nn 

where: 

library = either core image, relocatable, source statement, or procedure 

LBA = the number of LIBRARY BLOCKS ACTIVE for the library of interest and is obtained 

from a DIRECTORY (SYSTEM or PRIVATE) 
nn = LIBRARY LAST AVAILABLE ENTRY in the K (record) coliomn. 

Using the sample STATUS REPORT that follows, an example of how to compute a library size 
is: 

Relocatable Library = IBA/nn 

where: 

LBA = 11,9 57 
nn = 16, thus Relocatable Library = 11, 957 = 747.5 tracks 

16 

The relocatable library size computed does not include the tracks allocated for the 
directory. The directory size must be added to the relocatable library size computed. 
Thus, 

Relocatable Library Allocation = Relocatable Library + Directory Allocated Tracks 

Therefore, 

Relocatable Library Allocation = 747. 5+10 

= 757. 5 Tracks 

To find the number of required cylinders, divide the nuaber of required tracks by the 
number of tracks per cylinder. 

For this example, 

the Relocatable Library Allocation for a 3330 = 757.5 Tracks 

19 
= 39.9 or 40 cylinders, rounded high 



STATUS REPORT 



STARTING 
ADDRESS 
C H R 



DATE: 10/28/76 TIME: 14.44 

NEXT LAST DIRECTORY LIBRARY BLOCKS COND. DIR. TRACKS 

ENTRY ENTRY ENTRIES LIMIT OR LIBRARY 

CHRE CHRE ACTIVE ALLOCTD ACTIVE DELETD AVAIL BLOCKS CYLINDERS 



SYSRES VOL.SER.R29RES 
CORE IMAGE DIRECTORY 
LIBRARY 



000 02 01 000 10 0** 000 n 17 
000 12 01 0'*i 18 06 05'* 19 06 



11+02 



6528 5201 



1327 



10 
55 



SYSRES VOL,SER.R29RES 
RELOCATABLE DIRECTORY 
LIBRARY 



055 00 01 055 01+ 07 02 055 09 17 19 1't77 
055 10 01 092 17 06 095 19 16 



13280 11957 



1323 



10 
k2 



SYSRES VOL.SER.R29RES 
SOURCE-STMT DIRECTORY 097 00 01 
LIBRARY 097 10 01 



097 01 2k 05 097 09 27 09 
195 07 19 196 19 27 



500 



53730 52857 



873 



10 
100 



SYSRES VOL.SER.R29RES 
PROCEDURE DIRECTORY 197 00 01 
LIBRARY 197 05 01 



137 00 03 09 197 O"* 27 09 
197 11 38 197 19 "tO 



2k 



595 



272 



323 
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SYSTEM DIRECTORY AND LIBRARY TRACK CAPACITIES 

Figures 1-8 and 1-9 illustrate the DOS/VS systeir library directory and track capacities. 



r 1 

I Directory Entries Per Track | 

I ^ ^ ^_ 4 



Device 



Core Image | Relocatable 
Library j Library 
(Phases) j (Modules) 
+ 

variable | N.A. 

(maximum j- 

length | 34 
30 bytes | 

per entry) |- 

I 560 

I- 

I 340 

\ • 

I 760 



Source 
Statement 
Library (Books) 



Procedure 
Library 
(Procedures) 
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Figure 1-8. LIBEARIES -- System Library Directory Capacities (Entries 
per Track) 
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Figure 1-9. LIBRARIES — System Library Track Capacities 



Creating System Files 



THE PAGE DATA SET 

SYSVIS is the logical unit name of the data set that holds the virtual address area. 
It is created at IPL time from information provided by the system generation macro DPD 
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and/or the IPI DPD conunand. The user specifies the beginning cylinder address and the 
system calculates the size of the disk extent which is a function of the VSIZE 
specification and the disk device type, as follows: 

VSIZE = number of pages (blocks of 2K bytes) 
2 

r T 1 

I Disk Device Type | Blocks per Cylinder | 
y + ^ 

I 23m I 60 I 

l- + ^ 

I 3330 I im I 

y + ^ 

I 3340 I 36 I 

I I I 

1 3350 I 240 I 

L •--- --,.-— J 

The allocation requires full cylinders. 

RECORDER FILE (SYSREC) 

IJSYSRC is the filename of the recorder file that is used exclusively for output from the 
RMSR (Recovery Management Support Recorder) function. The data contained on IJSYSRC is 
edited and printed by the EBEP progran. The recorder file aast be defined, using 
appropriate DLBL and EXTENT statements* after the first IPL procedure has been perfocaed 
fol loving supervisor replaceaent and b^f9ye thg £4£§t ^Qh Sta^S!£&i l£ £&&&• 

The RMSR function makes several types of recordings on the recorder file, in chrono- 
logical order. The file is made up of records that contain information relating to: 

• nCAB and CCfl 

• Unit Check 

• Counter Overflow 

• Tape Volume Statistics 

• IPL/EOD 

• Miscellaneous Data Recorder (2715 error records, PRT1 buffer error records, 

3330/3340/3350 non unit-check records, 3800 internal log buffer) 

• POWER/VS RJE logging. 

The IJSYSRC file is defined as a disk extent for any DASD supported as SYSRES, and the 
extent cannot be a split cylinder file. The file should not be defined on an extent 
which includes a defective or alternate track, because data lay be lost. The DLBL and 
EXTENT statements should be included in the standard label area by specifying STDLABBL 
to allow recording to proceed at the beginning of each day without operator 
intervention. 

CREATING AND USING THE RECORDER FILE 

A ainiauB of ten tracks is required for the recorder file (STSBEC) . The following job 
stream creates the recorder file and stores the pertinent label information 
permanently in the standard label area. 

// OPTION STDLABEL 

// DLBL IJSYSRC^ 'DOS/VS RECORDER FILE' 

// EXTENT SYSREC,, » , , nnnnn , nnnnn 

/♦ 

ASSGN SYSREC, X'CUU* 

SET RF=CREATE 

'/ JOB FIRST 
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HARD-COPY FILE 



(Applicable to all systems that have a display operator console installed and DOC 
support generated) 

IJSYSCN is the filename of the recorder file that is used exclusively for output of 
information from the message area of the Display Operator Console. The symbolic 
device address of the hard-copy file is SYSEEC. 

The IJSYSCN file must be defined as a disk extent for any of the D0S/V3 supported 
disk devices, and cannot be a split-cylinder file. It is to be created after the 
supervisor has been link-edited and cataloged. The following file definition 
statements create the hard-copy file: 



ASSGN SYSREC,X'cuu' 

SET HC=CREATE 
// OPTION STDLABEL 

// DLBL IJSYSCN, "DOS/VS HARD COPY FILE" 
// EXTENT SYSREC,,, ,,nnnnn,nnnnn 



/* 

// JOB FI.<ST 



The IPL coiritiands that precede the first // JOB statement are not copied. After the 
file has been opened, the next available and last available records are determined and 
the standard IPL message 01 2 01 IPL COMPLETE FOR DOS/VS REL xx.x ECLEVEL=nn is written to 
the hard-copy file. 

When a new hard-copy file is created at IPL time, the records of the existing file are 
destroyed. 



Distribution of DOS/VS 

Figure 1-10 shows how DOS/VS is distributed. The system is shipped as a SYSRES file. 
This file contains the core image library, the relocatable library, the source statement 
library, and the procedure library. 



DISTRIBUTION OF THE SYSTEM FOR DASD USERS 

DASD users receive the system on one or more disk packs. The packs are ready for your 
system generation procedure. It is recommended that the pac.k(s) be copied ^nr" __tained 
for i>ackup- For label a ad exteint iaforB«itioa, reier to the "aeaorandmi to Users". 



DISTRIBUTION OF THE SYSTEM FOR TAPE USERS 

Tape users receive the system on a reel of magnetic tape. This distribution tape 
contains the system as SYSEES file; it must be restored to one or more disk 
volumes. Refer to "Restoring the Distribution Tape to Disk" later in this chapter, 
After the tape has been restored, retain it for backup. 
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Figure 1-10. How DOS/VS is Distributed 



Guidance on how to perforin a system generation is given under "System 
Generation and Maintenance". 



System Generation and Maintenance 

Each system generation job, that is, tailoring an IBM-supplied system to your individual 
needs, consists of a number of job steps. The job steps actually necessary and the 
sequence of their execution depends on the existing installation configuration and the 
operational packs to be built. Nevertheless, certain activities and their sequence are 
common to all situations so that a generalized system generation procedure can be 
followed. This general procedure is shown in Figure 1-11 for online and offline system 
generation. The various job steps shown are supported by programs which are listed and 
briefly described in Figure 1-12. 

For a more specific application of the generalized procedure, refer to "System 
Generation Example (Online)" where the job steps are explained in detail. 

The procedure that must be followed for processing the distribution tape (generalized 
in the frame part of Figure 1-11) depends on the availability of an operational DOS/VS. 

Users without an operational DOS/VS must restore the distribution in correspondence 
with the procedure described under "Processing the Distribution Tape (Standalone)". 

If an operational DOS/VS is available, the above mentioned standalone procedure »ay be 
used. However, it is recommended to follow the online procedure shown in the "System 
Generation Example", because it requires no standalone machine time. 
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Note 1 : If RELLDR'NO, linking of components 
is the responsibility of the user. 

Note 2: Only from background (BG) partition. 

Note 3: IPL for the 64K Model 11 5 CPU can only 
be performed via t$A$SUPO. 



Figure 1-11. General Procedure for System Generation (Online and Offline) 
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r r 

] Name jPrograir Description/Function 



h 



CSERV 



(core image library service) to punch out (or write on magnetic tape, disk, or 
diskette) programs from the core image library. 



SSERV 



(source statement library service) to puncn out (or write on magnetic tape, 
disk, or diskette) macro definitions from the source statement library. 



RSERV 



(relocatable library service) to punch out (or write on magnetic tape, disk, 
or diskette) the relocatable modules used to build IBM -supplied processor 
programs. 



PSERV 



(procedure library service) to display on SYSLST or to punch out (or write en 
magnetic tape, disk, or diskette) procedures from the procedure library. 



DSERV 



(directory service) to display on SYSLST the current contents of one or more 
library directories and their remaining library capacities.. The directory 
display may be either an alphabetically sorted listing or a listing of the 
entries in the order they appear in the directory. 



LSERV 



-+ 



(label cylinder display) to display on SYSLST the label cylinders located on 
SYSRES. SYSLST may be assigned to disk, tape, printer, or diskette. 



ESERV 



(de-editor p^"ogram) to de-edit pre-edited macros from the E-sublibrary. It 
provides SYSLST and SYSPCH output of the original macros. It also provides an 
update facility for one macro per job step. 



MAI NT 



(library maintenance) to delete and/or catalog library elements, and also to 
condense and reallocate library extents. 



BACKUP 



to create a backup of the system on tape and/or to create a backup of private 
libraries on tape. The tape is suitable as input for the Restore program. 
See Note below. 



RESTORE 



to restore the DOS/VS Distribution Tape in a partition of a current release of 
DOS/VS. The program may be executed by statements from SYSIPT or SYSLOG. 



CORGZ 



(copy or merge ) to copy all or to copy selectively and merge elements from 
one library to another. COBGZ allows larger or smaller allocations for each 
library of the SYSRES that is being created. 



Note ; Backup and Restore programs can be used efficiently to condense libraries and 



also to migrate libraries from one DASD type to another. 



Figure 1-12. Overview of Programs for System Generation and Maintenance 

For more details on these programs, refer to DOS/VS System Control 
Statement s and DOS/VS System Utilities . 
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Processing the Distribution Tape (Standalone) 

The following processing steps to initialize the disk pack to which the distribution tape 
is to be restored and to restore the distribution tape to the disk apply to installations 
that are without an operational DOS/VS. Machine configurations with and without card 
reader availability are covered. 

If your disk pack has not been initialized, follow the processing steps 
given under "Initializing the Disk", 

If your disk pack is already initialized, coirnience with the processing 
steps given under "Bypassing Disk Initialization". 

INITIALIZING THE DISK 

• Initialize the disk pack with a volume label and a volume table of contents (VTOC) . 
For the recommended addresses, refer to "Planning Summary" earlier in this manual. 

• Mount the distribution tape. 

• Ensure that the disk pack or data module is set for read and write operations: 

For the 3330 or 3350, set the write protection switch to R/W 
For the 3340, use a read/write data module 

• IPL from the tape unit that contains the distribution tape volume. 

• When the wait state is entered: 

For machine configurations that include a card reader, place "Job Steam A" in the 
card reader and press START and EOF on the card reader. 

For machine configurations that do not include a card reader, press ENTER on the 
DOC keyboard and when the signal sounds, type in "Job Stream A" via the DOC 
keyboard. Press ENTER key at the end of each statement; lowercase is converted to 
uppercase. 

Applicable to both types of machine configurations (with or without card reader 
availability) : 

If messages S328I and S328A appear on SYSLOG, type DELETE, hit END or ENTER 
depending on device type, and press INTERRUPT to delete unexpired files, one by 
one. To delete all unexpired files at once, type in DELETE ALL. 

The message S371I INITIALIZE DISK FUNCTIONS COMPLETED appears on SYSLOG when 
initialization is completed. 

On completion of initialization,, the system automatically initiates the restore function. 
You. can now continue with the steps given under "Restoring the Tape to Disk". 
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BYPASSING DISK INITIALIZATION 

If the disk pack to which the tape is to be restored is already initialized, proceed as 
follows: 

• Mount the distribution tape. 

• Ensure that the disk pack or data module is set for read and write operations: 

For the 3330 or 3350, set the write protection switch to R/W 
for the ^SMO,, use a read/write data module 

• IPL from the tape unit that contains the distribution tape volume. 

• when the wait state is entered: 

For machine configurations that include a card reader, place "Job stream B" in the 
card reader and press START and EOF on the card reader. 
- For machine configurations that do not include a card reader, press ENTER on the 
DOC keyboard and when the signal sounds, type in "Job Stream B" via the DOC 
keyboard. Press ENTER at the end of each statement; lowercase is converted to 
uppercase. 

On completion of these steps, the system automatically initiates the restore function and 
you can now continue with the steps given under "Restoring the Tape to Disk" . 



Job Stream A 



// JOB INTDSK 

// ASSGN SYSLOG,X'cuu',dc 

// DATE mm/dd/yy 

// ASSGN SYSOPT,X'CUU'' ,dc 

// ASSGN SYSOOn,X'cuu' ,dC 

// LOG 

// ASSGN SYSLST,X'cuu' ,dc 

// EXEC 

// UID nn 

// VTOC STETADB=(cccchhh) ,EXTENT=(yy) 

VOLlnnnnnn 

// END 

// JOB DISRST 

// ASSGN SYS005„X'CUUV,dc 

// ASSGN SYS006,X'cuu'^dc,X'SS» 

// ASSGN SYS007,X*cuu*,dc 

// ASSGN SYS008,X'CUUV, dc 

// ASSGN SYS009„X"cuu".dc 

// EXEC 



disk, see Note 1 
disk, see Note 2 

optional, see Note 6 

see Note 3 
see Note 4 
see Note 5 



system residence file to be created 

distribution tape 

if PVTCLB is to be built 

if PVTRLB is to be built 

if PVTSLB is to be built 



■H 



Job Stream B 



// JOB INTDSK 

I// ASSGN SYSLOG,X»cuu»,dc 
// LOG 

// DATE mm/dd/yy 

// FILES SYSIPT,,! 

// JOB DISRST 

// ASSGN SYSOOS^X'CUU' ,dC 

// ASSGN SYS006,X"CUU*,dc,X«SS» 

//ASSGN SYS007,X'cuu« ,dc 

// ASSGN SYS008,X'cuu',dc 

// ASSGN SYS009,X'cUU",,dc 

// ASSGN SYSLST,X'CUU",dc 

// EXEC 



system residence file to be created 
distribution tape 
if PVTCLB is to be built 
if PVTRLB is to be built 
if PVTSLB is to be built 
optional, see Note 6 



in Job Stream A and B, the job names INTDSK and DISF.ST must be used as shown 
For a description of the cuu, mm, dc, yy, and ss fields see Figure 1-13. 
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r " 

// DATE mir/dd/yy mm = 01-12 

dd = 01-31 
yy = 00-99 



T 



// ASSGM sySxxx,X»cuu«,dcC,X»ss« J 
XXX = logical unit 
cuu = channel and unit of device 

• The channels used by the distribution program supervisor are: 

Multiplexer (channel 0) 
Selector (1 through 6) 

dc = one of the following device type codes: 

Cl-3210/3215 Console Printer-Keyboard 
CR-Display Operator Console 

D3-23m/2319 Disk Drive 

D4-3330 Disk Storage Models 1 and 2, or 3333 Disk Storage, or 3350 Direct 

Access Storage in 3330-1 compatibility mode 
D5-33U0 Disk Storage (35 iregabyte data module) 
D6-3340 Disk Storage (70 megabyte data module), or 33UU Direct Access 

Storage 
D7-3330 Disk Storage Model 11 
D8-33$0 Disk Storage 

L1-1U03/1U0U Printer* 
L2-iaU3/lUU5 Printer* 
L3-3203, 3211, or 5203 Printer* 
L4-3800 Printing Subsystem 

R1-25U0 Card Read-Punch (reading only) 

R2-2 540 Using Punch-Read-Feed feature 

R3-14'*2 Card Read-Punch 

R4-2501 Card Reader 

R5-2520 Card Read-Punch 

R6-3505/3504 Card Reader 

E7-2560 MFCM or 5425 MFCO (read hopper 1) 

Tl-2400 or 3400 7-track Tape 
T2-2100 or 3400 9-track Tape 

The Restore program does not use this dd specification. Instead, the 
program determines the device type from the Format-4 label of the disk 
volume on the specified physical device. 

ss = 90 for 7-track tape unit 

CO for 9-track tape 1600 bpi 
C8 for 9-track tape 800 bpi 
♦For printers 1403, 3203, 3211, and 5203: 

ss = 7E - sense data checks 

= 73 - (default) block data checks (ignore) 
|. 

// VTOC STRTADR=(cccchhh),EXTENT=(yy) 

cccchhh = cylinder and head number of starting address 
yy = number of tracks allotted to VTOC in decimal (1-30) 
|. ^ 

jVOLlnnnnnn nnnnnn = Volume Serial Number | 

L J 

Figure 1-13. Coding Specifications for // ASSGN Statements within the Distribution 
Program Job Control 

(Refer to the preceding text "Processing the Distribution Tape".) 
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Notes to Job Streams A and B 

1- Assign SYSOPl to the disk that is to be initialized. 

2. n = 2, 3, 4, or 5. SYS002 through SYS005 are optional to specify additional disk 
devices to be initialized. These disk devices rrust be of the same device type as 
SYSOPT. 

3. Refer to DQS/VS Syst e in Utilities , for a ccrrplete description of the TJID control 
statement. 

For 231U/2319, nn= 

IR Previously flagged tracks are to retain their flags without surface analysis, or 

lA Denotes surface analysis on all tracks. Generation of home address (HA) and rO 
records, pref ormatting of IPL records, writing of volume label and VTOC, or 

IS For packs that have already been initialized this entry can be used to change 
the volume label (s) and the VTOC location. 

For the 3330, 3340, or 3350 Disk Storage, nn= 

IQ Quick initialization. No surface analysis. No home address generation, only 
standard RO generation, IPL records are preformatted, volume labels and VTOC 
are written, or 

IS Same as IS for 2314/2319. 

4. For 2314/2319: cccchhh = 0199000 yy = 20 
For 3330: cccchhh = 04 03000 yy = 19 
For 3330-11: cccchhh = 0807000 yy = 19 
For 3348/35ME: cccchhh = 0347000 yy = 12 
For 3348/70MB: cccchhh = 0695000 yy = 12 
For 3350: cccchhh = 0554000 yy = 30 

For each output disk specified (maximum 5) a set of 

// VTOC STRTADR= (cccchhh) ,EXTENT=(yy) 
voLlnnnnnn 

statements are to be added, 

5. nnnnnn = Volume serial number (trailing blanks only should be used). 

The IBM- supplied supervisors and standard label procedures assume nnnnnn-SYSRPJS for 
the system residence volume. 

Columns 42-51 are reserved for user's identification, A label control set consisting 
of a VTOC control statement and a VOLl control statement is required for each pack 
assigned. The label control sets apply to the assignments in the order as specified 
in the job stream and not in strict numerical sequence. 

6. If SYSLST is assigned, all messages and other output from the initialize disk phases 
to the communications device are also printed on SYSLST. 
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BESTOEING TBE TAPE TO DISK 

After coapleting the processing steps given under 'Initializing the Disk', or 'Bypassing 
Disk Initialization', the restore distribution tape to disk procedure is perforaed 
iftiaediately. 

The systeffl issues the fcllowing t¥o-part message: 

SB01D ♦**GIVE SYSTEM LIBRARY ALLOCATIONS*** 
CL= 

Type in the required allocation for the systea core image library, using the format shown 
under 'Allocations', below, and press the ESD or ENTER key depending on device type in 
use. 

The systeffl will now proapt you for your allocations for the systea relocatable library, 
the system source statement library, and the procedure library, using the nessage RL=, 
SL=, and PL=, respectively. 

After these allocations have been entered, the two-part aessage: 

SR32D TYPE DESIRED LABEL FOR LIBRARY 
LABEL= 

is issued. Type in the desired label to be entered in the VTOC for the system residence 
file (44 characters aaxiium) and press the END or ENTER key. If you do not type in a 
label, but respond with END or ENTER, the label will be DOS. SYSRES. FILE. The system now 
issues the message: 

SE09D TYPE GO IF ALLOCATIONS IS CORRECT 

Type in GO and press the END or ENTER key. If you want to change the allocations, just 
press the key without typing in GO, whereupon the systea issues again the message SR01D. 
If you type in GO and press the END or ENTER key, the systea successively issues the 
following procedural messages, provided no faults are encountered: 

SRIOI FILE ID=xxx. ..xx (44x) 

SR1TI EITENT=CYL xxxTBKxx-GYLxxx TEKxx 

SE12I RESTORE OF SYSTEE CORE IHAGE LIBRARY IN PROGRESS 

SR17I RESTORE HAS BEEN SOCCESSFDL 

SR12I RESTORE OF SYSTEK RELOCATABLE LIBRARY IN PROGRESS 

5B17I RESTORE HAS BEEN SDCCESSFDL 

SRI 21 RESTORE OF SYSTEP SOORCE STATEHENT LIBRARY IN PROGRESS 

SRI 71 RESTORE HAS BEEN SOCCESSFOL 

SR12I RESTORE OF SYSTER PROCEDURE LIBRARY IN PROGRESS 

SRI 71 RESTORE HAS BEEN SOCCESSFHL 

SE14I *** RESTORE COHPIETE*** 

Besides procedural messages, error messages aay be issued in the course of the library 
allocation procedure, r€fer to DOS^VS Messaags. 

Allocations: 

The basic allocation format is ccc(tt), where ccc is the number of cylinders to be 
allocated to the library and tt is the number of tracks within these cylinders which are 
to be teserved for the directory. 

If an allocation of 0(0) is specified for any library, this library will not be restored. 
If you reply with EOB when prompted for the allocation, the default allocations from the 
distribution tape are used. 
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Note that these default values are the ninimun library and directory space required. 
Therefore, you should alvays specify the values you actually need. The default values 
cannot be used irhen restoring the systeii to a 23m or 3340 Model 35 because the storage 
capacity of these devices is too sdall for all system libraries. In such cases, one or 
aore of the systea libraries must be restored as private libraries. Further details on 
this procedur6 and def a Ult values are contained in the •Hemorandua to Users*. 

If Eccc(tt) is specified (this is only possible for BL, PL, and SL) , the requested aaount 
of space will be allocated, but no entries will be aade. This results in generation of 
an €iapty library. 

It is possible to restore systea libraries {CL, EL, SL) , as private libraries if you 
wish, by specifying CL=PVT when proapted for the system library allocations. Tn this 
case, the allocations aost be given for the corresponding private libraries, and the 
system will prompt you accordingly. For details refer to 'Backup and Restore* in DOS/VS 
Sxs^m gtiXJ-ties. 



Link-Edit and Delete Procedures 



The IBM-supplied systea includes cataloged procedure to perform system generation 
link-edit and delete functions for IBM-supplied systea prograas; the system components 
are pre- linked in the distributed systea. 

The full naae of the procedure to be link-edited or deleted aust be formed by 
concatenating: 

Prefix+Keywordt£ Suffix] 

The prefix is always LINK for link-edit functions, and is always DELE for delete 
functions. Select the keyword and the suffix froa Figure 1-1«* according to the function 
desited; do not use the suffix for link-edit functions. 

Ex a aple J: To link-€dit assembler and ESER? programs to the core image library, the 
necessary statement is 

// EXEC PEOC=LIHKASM 

gxameie 2: To delete BTAM from the core image library, the necessary statement is 

// EXEC PROC=DELEBTI!C 

To delete a given component contained in different libraries, a separate procedure must 
be executed for each library. The suffix CBS (to cover all thtee libraries) is not 
valid. The statement // EXEC PEOC=DELEBTMCES, for example, would be invalid and not 
result in a deletion of BTAM from the libraries (core image, relocatable, source 
statement) designated by the suffix. 

Users who specifies EE£LDF=HO must re-link all desired components after IPLing a new 

supervisor. 

It is recommended to retain the link-edit and delete procedures for use after system 
generation time. The procedures can be useful for linking specific system programs to a 
private library, or for deleting programs no longer required from a private library. 
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JAPC 


c 


R 




X 


Analysis Program- 1 




|ASM 


c 


R 




X 


Assembler and ESERV Programs 




|ATD 


c 


R 


i 1 


X 


ASSGN Alternate Track Disk Utility 




|BTM 


c 


R 


s 1 1 




BTAM 




JCDC 


c 


R 




X 


Clear Data Cell utility 




JCDD 


c 


R 




X 


Restore Card to Disk Utility 




|CDK 


c 


R 




X 


Clear Disk Utility 




|CD1 




R 






IOCS Nodules for IBM 1442 




|CD2 




R 






IOCS Modules for IBM 2501 




|CD3 




R 






IOCS Modules for IBM 2520 




|CD4 




R 






IOCS Modules for IBM 25 40 




1CD5 




R 






IOCS Modules for IBM 2560 




icD6 




R 






IOCS Modules for IBM 350 5 




|CD7 




R 






IOCS Modules for IBM 3525 




|CD8 




R 






IOCS Modules for IBM 5425 




|CRD 


c 


R 




X 


Copy and Restore Diskette Utility 




|DAM 


c 


R 


s ! 1 




Direct Access IOCS 




|DDC 


c 


R 




X 


Copy Disk or Data Cell to Tape Utility 




|DEL 






1 P 1 




Delete all Delete Procedures 




JDGN 


c 


R 




X 


Dump Generator 




|DIO 


c 


R 


s 1 1 




Diskette IOCS 




|DKC 


c 


R 




X 


copy Disk to Card Utility 




|DKD 


c 


R 




X 


Copy Disk to Disk Utility 




]DOC 


c 




s I 1 




Display Operator Console Support 




|DSK 






s 1 i 




Sequential Disk IOCS Macros 




|DST 


c 


R 


1 1 


X 


Deblock Utility 




|ERP 


c 


R 1 




X 


EREP 




|E20 


c 


R 1 


s 1 1 




Model 20 Emulator Prograu. and Data Interchange 


Function 


|FCY 


c 


R 1 


s 1 1 


X 


Fast Copy Disk Volume Utility 




|HSD 


c 


R 1 




X 


Highspeed Standalone Dump 




|IDC 


c 


i^ 




X 


Initialize Data Cell Utility 




JIJB 




R ] 






System Control Modules 




1 IND 


c 


R 1 




X 


Initialize Disk Utility 




|INT 


c 


R 




X 


Initialize Tape Utility 




|ISM 


c 


R 1 


s 1 1 




Index Sequential Disk IOCS 




|IVP 






s ! 1 




Installation Verification Procedures 




1 JBA 




R 1 




X 


Job Accounting 




|JCL 








X 


Job Control 




|KJI 


c 








Kanji Printer Support 




|LBR 


c 






X 


Librarian Programs 




|LNK 






1 P I 




Delete all Link Procedures 




IMCR 


c 




s 1 1 




Magnetic Character Reader Support 




1 OBJ 


c 


R 




X 


Copy File and Maintain Object Module Utility 




|OCR 


c 




s 1 1 




Optical Character Reader Support 




|OLT 


c 


R 




X 


OLTEP 




|PDA 


c 


R 




X 


Problem Determination Aids 




jPDS 


c 


R 




X 


Page Data Set Dump Utility 




|PLG 


c 


R 




X 


Print the Hard-Copy File 




|PLI 




R 






PL/I Optimizing Compiler IOCS Modules 




|PRT 


c 






X 


Buffer Load for 3203, 3211, and 5203 Printer (( 
print patterns must be link-edited later) 


optional 


|PTP 

1 J 


c 

L J 





s 1 1 

L X X_ 




Paper Tape IOCS 







Figure 1-14. Keywords and Suffixes for Link-Edit and Delete Functions (Part 1 of 2) 
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1 
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LX 
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1 




1 of 


V 


"T 


T- 





■T 
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Description Of Component that is to be 




j Procedure | CLE | RLE | 


3 LB 1 PLB 1 




[Linked or Deleted 




1 


_J 


..J 


— L- 




.4. 


L - 


J 


4 


j PWR 






--!-" 


S 




"^^■^ 




POWER/VS 




IQTM 


1 c 


1 R 




S 








QTAM 




IRPG 




1 K 












RPG II Compiler IOCS Modules 




|RPS 


! c 














[Rotational Position Sensing 




jRST 


1 c 


1 R 










X 


Backup and Restore Utility 




JSAP 








s 








1 Sample Programs 




iSDA 


1 c 


1 ^ 










X 


SDAIDs 




1 STD 


i c 


1 i^ 










X 


Standard System Dump 




I SUP 








s 








Supervisor Generation Macros 




JTAP 


1 c 


j R 




s 








Magnetic Tape IOCS 




|TDC 


! c 


1 R 










X 


Restore Tape to Disk or Data Cell Utility 




jTPl 


1 c 














Transients for Type 1 Programs 




iTRD 


1 c 


1 R 










X 


Translating System Dump 




i UTS 














X 


Maintain System History Utility Program 




]VSM 


j c 


1 R 




s 






X 


VSAM and Access Method Services 




jVTC 


1 c 


! R 










X 


VTOC Display Utility 




|VTM 


! c 


1 R 




s 






X 


VTAM and TOLTEP 




! VTS 








s 








VSAM and VTAM Common Macros 




1 ZAP 


i c 


1 R 










X 


CIL Patch Program (PDZAP) 




{. 


L 


.J 


.±. 




.X 


_j._ 


1 


J 


1 Note: Th 


e proceduri 


es 


DELEDELP < 


ind DELELNKP are for documentation, they cannot be 


— 1 


1 executed 


via 


the 


procedu 


re 


library. For execution, these two procedures have to be 




j punched 


out a 


md € 


mtered 


via SYSIN. 





Figure 1-14. Keywords and Suffixes for Link-Edit and Delete Functions (Part 2 of 2) 
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Generation and Maintenance Considerations 



VOLUME SERIAL NUMBERS AND LABELS 

If the IBM-supplied system is on disk, the serial number of that disk pack is SYSRES. If 
the system is shipped on tape, the disk pack to which the tape will be restored is 
assigned a volume serial number during the initialize disk run. 

For both types of IBM-shipped systems (tape and disk) , the standard labels defined by 
the DLBL and EXTENT statements are adequate for system generation, but the EXTENT 
statements oust be adjusted to reflect the volume serial number chosen for the disk 
volume to which the tape is to be restored. To use the standard labels for 
configurations with two disks, STSLNK, SYSOOI, SYS002, and SYS003 can be assigned to the 
second disk. IBM supplies procedures LABELS30, LABELS^tO, and LABELS50. These procedures 
load standard labels for the 3330, the 3340 Model 70, and the 3350, respectively if 
default sizes for the libraries are used when the system is restored. 

Standara labels (OPIION STBLABliL) are not defined for any file on tht- system 
aistributed by IBM. A reply of "delete" to the message 

kUHHk OVERLAP ON UNEXPIRED FILE 

destroys the system residence file unless it is encountered during a HAINT reallocation 
run. 



COMPILATION OF IOCS MODULES 

To use some compilers, a number of IOCS modules must be cataloged in the relocatable 
library of each operational pack. IBM supplies these modules preassembled in the 
relocatable library for the compilers that use them. These IOCS modules are link-edited 
into compiler generated object programs as required. These modules are generated using 
the following macro definitions supplied by IBM: 

CDMOD Card Reader/Punch - 3 881 Optical Mark Reader 

PRMOD Printer 

MTMOD Magnetic Tape 

SDMODxx Sequential DASD. SDMOD consists of ten similar macro definitions: SDMODFI 
for sequential disk with fixed input, SCMODFO for sequential disk with fixed 
output,, and so on. A complete description of SDMODxx is contained in DOS/VS 
Supervisor an d I/O Macros . 

ISMOD Index Sequential Access Method, DASD 

DAMOD Direct Access Method, DASD 

DIMOD Device Independent Module 

With assembler language you can, if you wish, assemble these IOCS functions separately 
and catalog them into the relocatable library. Separate assembly of IOCS modules 
requires no additional real storage or additional execution overhead. Those modules, 
shipped preassembled for IBM components,, can also be used by any other program, if 
applicable,. A separate assembly is preferable because: 

• Program assembly and reassembly time is minimized. 

• IBM-supplied IOCS modules used . by compilers may also be used by your application 
programs- Use of these modules reduces the assembly time of your application 
programs.. 
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• Use of preassembled IOCS modules facilitates program maintenance and standardization. 

• The xxMOD macro definitions just cited require a substantial number of cylinders in 
the source statement library. 

The corresponding generated modules ordinarily require fewer cylinders in the 
relocatable library. Thus* you may prefer to retain xxMOD macro defintions only on 
the system backup volume, cataloging a selection of generated modules onto each 
operational volume. 

Support of the RPS feature of IBH 33zx disk storage devices is provided in S&H and DAN, 
and Device Independent Access Hethod by preasseibled and link-edited versions of the 
logic modules that reside in the core image library and are subsequently loaded into the 
SVA. This support is also provided in ISAM for IBM 3330 Model 1 or 2, 3333, or 33U0. 
The modules are linked to the problem program during execution of problem programs and 
process the DTP requests. BPS modules are usable by DASD'DTFs in your system. Only one 
copy is in the SVA if pre-loaded during IPL, otherwise multiple copies in the system 
GETVIS area can occur. If BPS support is not used, these modules can be deleted from the 
core image library. 

AVOIDING LOSS OF SYSTEM LIBRARIES 

During each system generation and maintenance procedure, system libraries should be 
copied periodically on magnetic-tape reels or disks to provide backup in case of 
subsequent specification errors or machine errors. 

The programs Backup or FASTCOPY can be used for copying from disk to tape; the CORGZ 
or FASTCOPY programs can be used for copying from disk to disk. Using Backup and Restore 
together, or the program CORGZ, your libraries will be condensed. For details of these 
programs refer to DOS/VS System Control Statements and O OS/VS System utilities . 

OBTAINING LIBRARY STATUS INFORMATION 

Perform a DSERV, or check a system directory printout to determine the contents and sizes 
of the system libraries during system generation to determine that enough blocks remain 
for link-edit and catalog procedures. A DSERV run requires the following control 
statements : 

// JOB DSERV 
// EXEC DSERV 
DSPLYS ALL 
/* 
/£ 

A printout of the library status is provided automatically following a linkage edit with 
an OPTION CATAL Specified or any // EXEC MAINT. 

USING SYSRES LIBRARIES AS PR IV ATE LIBRARIES 

Before changes can be made to one of the system core image, system relocatable, and 
system source statement libraries of a non-IPLed system, the respective library must be 
declared as private. To do so, it is required that DLBL and EXTENT statements defining 
the exact library size are included into any job stream making use of the libraries. The 
following examples show the required job control statements: 

For a system core image library: 

// DLBL IJSYSCL,, ' DOS . SYSRES . FILE » 
// EXTENT SYSCLB,SYSRES,1,0^2,197 8 
ASSGN SYSCLE,X'161' 
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For a system relocatable library: 

// DLBL IJSYSRL, 'DOS, SYSRES. FILE' 

// EXTENT SYSRLB,SYSRES,1„ 0,1980, 201*0 

// ASSGN SYSRLB,X"161' 



For a system source statement library: 

// DLBL IJSYSSL,, 'DOS. SYSRES. FILE' 

// EXTENT SYSSLB,SYSRES,1„0, '♦0 20, 2820 

// ASSGN SYSSLB,X'161'' 



AUTOMATIC DOCUMENTATION OF SUPERVISOR GENERATION MACROS 

Normally, when examining a supervisor listing, it is difficult to determine which 
supervisor generation macros were used for the assembly. If, however, the supervisor 
generation macros are invoked by means of an outer user macro (which in turn calls the 
required generation macros) then the assembler will list the outer macro before 
assembling the supervisor, and thus all the generation macros used are listed together. 
All that is required to use this technique is the insertion of the four macro 
instructions labeled (J) through (5) below (refer also to Figure 1-6): 

// EXEC ASSEMBLY 

MACRO (T) 

GENSOPVE © 

noraal sapervisor generation job 
stream without the END statenent 

(D 

GENSUPVR 

END 
/♦ 
UTILIZATION or THE MAINTAIN SYSTEM HISTORY (PTFHI5T) PROGRAM 

To have a history of system updates available is a prerequisite for efficient system 
service, it helps to reduce system down-time. Therefore, whenever a new release of 
DOS/VS is installed, the PTFHIST program should be initialized and linked to the core 
image library of your DOS/VS. 

When a system update (by APAR fix or by installation of one or more PTFs) is performed, 
this should be done only with the PTFHIST program. 

Linking the program and using PTFHIST for system update are the prerequisites for 
automatic maintenance of the system update by DOS/VS, 

The system generation example given later in this module shows how to initialize the 
program and link it to your system core image library. Refer to jgQS^VS System fitiiities 
for information on how to use the program. 

Another important tool for efficient system service is the IBM- provided List System 
History (HISTLIST) utility program. This program produces system history listings that 
are helpful when the system service level needs to be established. Refer to 22S/YS 
§l§i§fi gt^ljties for information on how to use the program 
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Library Maintenance 

DOS/VS libraries can be maintained by using the MERGE function of the CORGZ librarian 
program. The MERGE function allows to merge complete libraries or selective library 
entries into existing libraries. Before using the MERGE function, ensure that the 
library to vhich new entries are to be merged contains sufficient space for the new 
entries. The following discussions apply to all libraries. For further information 
refer to DO^/V^ gys^em £2!li£2i statements. 



EEPLACING IDENTICAL ENS^IgJ OSING THE MERGE FUNCTION 

When transferring entries that have names identical to those of existing library entries, 
the old entry (name of phase, module, book, or procedure) is deleted from the library's 
directory, and the new entry is added to the end of the library's directory. The phase, 
module, book, or procedure is added to the end of the library. 



A£2ING UNIQUE SNTRJES UglNG THE MERGE FUbCTIQN 

When uniquely named phases are transferred to an existing core image library, the names 
of the entries are inserted in the directory in alphabetical sequence for modules, books, 
or procedures, the entries are inserted at the end of the directory. The actual phase, 
module, book, or procedure is added to the end of the library. 

COPYING SELECTIVELY TO M ERGE LIBR ARIES 

If two libraries are to be merged, it is faster to selectively copy (MERGE) to the 
library containing the greatest number of desired entries because the number of entries 
transferred and directory searches made are kept to a minim\jm. If there is insufficient 
space in a library to accommodate additional entries, unwanted entries can be deleted, 
the library can be condensed,, and the new entries can then be added to the library. 

DELETING UNWANTED ENTRIES AND MERGING AN ENTIRE LI BRARY WI TH ANOTHER LIBRARY 

A second technique is to use the IBM-supplied delete procedures to delete all unwanted 
entries from a library and copy the entire library to another library, thus merging the 
two libraries. Using this technique requires that the receiving library contains enough 
space to accommodate the entire library being copied. If there is insufficient space, 
the receiving library must be condensed or reallocated. 

COPYING SELECTIVELY FROM TWO LIBRARIES TO CREATE A THIRD LIBRARY 

If there is insufficient space to accommodate a merge of two libraries, a third library 
can be created to contain selected entries from the two libraries that are to be 
contained in the merged library. This technique eliminates the need for condensing or 
reallocating an existing library. Note that this technique can be applied by using only 
two disk drives. 

DELETING UNWANTED ENTRIES FROM TWO L IBRARIES AND MERGING BOTH LIBRARIES TO CREATE A THIRD 
LIBRARY 

Another technique for merging two libraries is to delete unwanted entries from the two 

existing libraries,, and merge the two libraries, in their entirety, by copying them to 

create a third library. Note that this technique can be applied by using only two disk 
drives. 
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System Generation Example (Online) 

The following illustrates an online system generation joJo with a system and I/O device 
configuration as shown in Figure 1-15. The job steps required for this generation are 
illustrated in Figure 1-16 with accompanying text explaining the steps in detail. 

The example applies to both the tape and the disk distributed systems. Prerequisite 
is an operational DOS/VS. Users without an operational DOS/VS are referred to 
"Processing the Distribution Tape" in the preceding text, before commencing with the 
generation job. 




Current SYSRES 

Unit X'160' (IPL-Device) 

SYSRES 

SYSVIS 

SYSLNK 

SYSOOl 

SYS002 

SYS003 

SYSREC 



Unit X'OOD' 



3330/ 
3340 



New SYSRES 
UnitX'161' 



SYS LOG 



Device 



Channel 



SYSLST 



Unit 



SYSRDR 
SYSIPT 



SYSPCH 



■' 




— 


3505 





oc 


3525P 





OD 


3211 





OE 


3210/3215 





IF 


3330 or 3340 


1 


60 


33X or 3340 


1 


61 


341 0T9 


2 


80 



Use 



Card Reader (SYSRDR, SYSIPT) 

Card Punch (SYSPCH) 

Printer (SYSLST) 

Display Operator Console 

Disk (SYSRES, SYSLNK, SYSREC, SYSOOl, SYS002, SYS003) 

Disk (new systems to be generated) 

Magnetic Tape 



Figure 1-15. Example of System and I/O Device Configuration 

Results of System Generation 

When system generation is completed, the operational system pack of the installation 
contains user selected components and programs in its core image library, together with 
an IBM-supplied or the installation's tailored supervisor and the job control, linkage 
editor, and librarian programs. The core image, relocatable, and source statement and 
procedure libraries are condensed, and IOCS modules are assembled and cataloged to the 
relocatable library. 
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* For generating POWER/VS 
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Figure 1-16. Job Steps of Online System Generation 
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DESCBIPTION OF JOB STEPS 

Users receive the IBM-shipped systen according to their installation's device 
configuration. 

Tape users receive DOS/VS on a self-loading reel of magnetic tape which is capable of 
being restored onto disk* The tape contains the entire SYSRES file. The generation 
exanple assuaes an operational DOS/VS. To cosoence the generation job, sount the 
IBfl-supplied tap^ and proceed to step 1 of the example* 

Users without an operational DOS/VS must first complete the procedures described 
previously under 'Processing the Distribution Tape (Standalone)' and only then can they 
commence the generation job* starting with Step 13 and continuing in the following step 
sequence: 1*1, 5 through 12 followed by St^ps 15, 16, and 17. 

DASO users receive DOS/^S on a disk (data module) containing a core image, relocatable, 
source statement, and a procedure library. To commence system generation, mount the 
IBn-supplied volume and proceed to Step 3 of the example. 

As indicated in Figure 1-16, some of the steps may be performed only from the background 
(EG) partition. 



^^§£ O l Pi tiaj.4ze j^he Disk 

Users of VM/370 restoring DCS/VS to minidisk(s) must initialize such disk(s) by means of 
the initialise disk utility IBCDASD (available with 7H/370) and specify the number of 
cylinders required. Then, the OS work p^ck must be converted into a work pack suitable 
for DOS/VS. To do so, specify// OID IS in the utility modifier statement of the DOS/VS 
Initialize Disk Utility (see D OS/ VS System Dtilities) . 

Mount the distribution tape, if you plan to use a removable disk pack for system 
residence, and the disk that is to contain the system. For details refer to DOS/ VS 
Sy ste m m ^ ilitiefi. If th^ disk is not yet initialized, run the Initialize Disk utility. 

Given below is a sample job stream for system residence on a 3348 data module, model 70: 



// JOB 
// ASSGN 
// EXEC 

// OID 
// VTOC 
V0L1SYSBES 
// END 



INIT 334 8 HOD 70 

SYS000,X»161« 

lUTDK 

IQ 

STBTADR=(0695000) ,EXTENT=(12) 



For other disk volumes* the values to be specified for parameters STBTADR and EXTENT are 
as follows: 

STfiTADF= (0403000) for a 3336 disk pack; (0807000) for a model 11 disk pack 

STBTADP= (0199000) for a 2316 disk pack 

STETADR=(03470CO) for a 3348 data module, model 35 

STBTAD£?= (0695000) for a 3348 data module, model 70 

STfiTADH== (0554000) for a 3350 

EXTENT=(19) for a 3336 disk pack, all models 

EXTENT=(20) for a 2316 disk pack 

EXTENT={12) for a 3348 data module, model 35 

EXTENTS (12) for a 3348 data module, model 70 

EXTENT=(30) for a 3350 
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5i®E O IS§l2I§ t^§ Disk 



For details see 'Backup and Eestore Systea* in DpS/VS System Util it ies. 
For 33^8 data nodule, acdel 70 



new systea residence pack 

(see Note 1) 
distribution tape 



// JOB RESTORE TO DISK 

// ASSGN SYS0C5,XM61' 

// DLBL IJSYSfiS, 'DOS. SISSES. FILE', 99/365 

// EXTENT SYS005,, 1,0, 1,2887 

// ASSGN SYS006,X'280' 

// EXEC RESTORE 

ALLOC CL=25(6) ,EL=36 (6) ,SL = 87{4) ,PL=3 (3) (see Note 1) 

HTC EON,SyS006 

ii2i§ X' Extents and allocations are a sample for a 3348 data module. For further details 
on extents, refer to the 'Heinorandun to Osers.' 

For 3348 data module, nodel 35 and 2316 disk pack, the systea as distributed is too large 
for a single pack. The following job stream should be used for restore: 

// JOB RESTOBE DISTBIBOTIOH TAPE TO T90 PACRS 3348-35 



new system residence pack 

(see Note 2) 
distribution tape 

(see Note 2) 



private library on X'161' 
private source statement library 



// ASSGN SYS0C5,X'161« 

// DLBL IJSTSES,' DOS. SYSBES. FILE', 99/365 

// EXTENT SYS0O5,,1,O,2C51 

// ASSGN SYS006,X»280' 

// EXEC RESTORE 

ALLOC CL=5g(9) ,RL=94 (8) ,SL=E8 (2) ,PL=8(3) 
/* 

HTC EEW,SY£006 
// PADSE 

// ASSGN SYS009,X' 161' 

// DLBL IJSYSSL, 'DOS. SYSSLB. FILE', 99/365 
// EXTENT SYS009,,1,0,12,2784 
// EXEC BESTOFE 

ALLOC CL=P^T,PS=23 (4) 

/* 

HTC EUN,SYS006 

/e 

Note 2: Extents and allocations are a sample for 3348-35. For further details on 
extents, refer to the 'Hemorandua to Users'. 

The Restore program can be used online under control of a previous DOS/VS release. 
However, the program must be cataloged to the current systea before it can be executed. 
To catalog the program, invoke the job stream contained on the fourth file of the 
distributed tape from the console as follows: 



(see Note 2) 



1 . Enter commands 

ASSGN SYSIN,X'280' 
HTC FSF,SYSIN,3 



2, Press END/ENTEE 

3, Enter commands 



(distribution tape) 

(for a 1600 bpi tape; for an 800 bpi 
tape enter HTC FSF,SYSIN,1 for the second 
volume) 

(causes the Restore program to be cataloged) 



HTC eEW,SYSIN 
ASSGN SYSIN,X»CUU« 



(input reader) 
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Note : If a phase with the name RESTORE is already present in the current system, ensure 
that it is not overwritten. This can be done by either of the following: 

• Catalog the new RESTORE phase into a private core iirage library, or 

• Rename the current phase before executing the above job stream. 

Ste p ® Copy the New Procedure Library to the Curre nt System 

This step can only be executed in the background partition of the system. 

To copy the new system procedure library to the current system procedure library, use 
the following job stream. 

// JOB COPY 

// ASSGN SYS002,,X'161' 

// DLBL IJSYSRS, 'DOS,. SYSRES. FILE' 

// EXTENT SYS002, SYSRES 

// EXEC CORGZ 

MERGE NRS,RES 

COPYP ALL 
/* 
/6 

Note : When copying the new library to the current systeni procedure library, procedures 
having the same name will be overwritten. Also, ensure that the current procedure 
library has sufficient space to accommodate the new procedure library. 

Step O Use System Li b raries as Privat e Libraries 

Systeni libraries supplied by IBM can be used as private libraries of an existing DOS/VS 
if that system's supervisor was assembled with PCIL=YES specified in the FOPT generation 
macro. This approach requires that DLBL and EXTENT statements as shown are included in 
the pertinent job stream for each of the three system libraries: 

// DLBL IJSYSxL,* DOS. SYSEES. FILE' 

// EXTENT SYSxLB, SYSRES, 1,0,trackaddress, no. of tracks 

where x = C for core image library 
E for relocatable library 
S for source statement library 

trackaddress = 2 for private core image library; for the remaining two libraries, this 
address has to be computed by adding the length of the preceding library 
(including its directory) to the address of that library. 

no, of tracks= length of the library in n\imber of tracks. 
Step © Delete Unwanted C ompo nent s 

This step can only be executed in the background partition of the system. 

Delete unwanted components by executing the appropriate procedures. Declare new 
libraries as private libraries. Example for a core iirage library: 

// DLBL IJSYSCL, 'DOS. SYSRES. FILE' 

// EXTENT SYSCLB,SYSRES„ 1,0, 2,1978 System core image library portion 

ASSGN SYSCLB,X''161' 

Step O Assemble Your Own Supervisor 

To access the new system release while under control of the current system, the 

new libraries must be defined as private libraries; refer to "Use System Libraries as 

Private Libraries", above. 
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In this step, decide whether to use one of the IBM-supplied supervisors or to asserrble 
your own supervisor. Display the source (contained in the source statement library) of 
the IBM-supplied supervisors (contained in the core image library) by executing: 

// JOB DSPLY 

// DLBL IJSYSSL, 'DOS. SYSRES. FILE* 

// EXTENT SySSLB,SYSRES,, 1,0, a020, 2880 

// ASSGN SYSSLB,X'161' 

// EXEC SSERV 

DSPLY A. SUP0,A.SUP1, ,A.SUP6 

/* 
/& 

If one of the IBM-supplied supervisors suits your requireirents, continue with Step 8. 
Otherwise, assemble your own supervisor using DLBL and EXTENT statements as in the 
following example for a new source statement library (see also Figure 1-6) : 

// DLBL IJSYSSL, 'DOS. SYSRES. FILE' 

// EXTENT SYSSLB,SYSRES„1,,0, 4020, 2880 

// ASSGN SYSSLB,,X'161' 

Por 6^K Model 115 CPU configurations, either select $$A$SOP0 or assemble a supervisor 
whose storage requirements do not exceed 44K bytes. $$A$SUPO provides for a single 
partition, includes EELLDR=YES, but does not support POWEE/VS. Device assignments are 
identical to those for $$A$SUP1 (see Figure 1-2U) . 

Step Q Catalog Your Supervisor 

Catalog the assembled supervisor (object module from Step 6) to the core image library. 
Also catalog printer form-control buffer and the universal character buffer images as 
required (see "Buffer Load" later in this module) . 

// JOB CATALSUP 

// DLBL IJSYSCL, 'DOS. SYSRES. FILE' 

// EXTENT SYSCLB^SYSRES,1,0,2,197 8 

ASSGN SYSCLB,X'161' 

// OPTION CATAL 

ACTION CLEAR 

INCLUDE 

Supervisor object deck here 
/* 

// EXEC LNKEDT 
/& 

Step ® Backup Libraries 

The following job stream may be used to create a backup of your system and/or private 
libraries on tape. The backup is suitable as input to the Restore program. For the 
Restore JCL, refer to Step 2. 

// JOB BACKUP SYSTEM AND/OR PRIVATE LIBRARIES 

// ASSGN SYSO05,X'cuu' system library disk, if system backup desired 

// ASSGN SYS006,X'cuu' tape where backup is to be written to 

// ASSGN SYS007,X'cuu' private CLE., if backup is desired 

// ASSGN SYS008,X'cuu' private RLE, if backup is desired 

// ASSGN SYS009,X'cuu' private SLB, if backup is desired 

* Unassign any library that is not to be backed up 

// ASSGN SYS004,UA if Standalone tape is not to be produced (see Note) 

// DLBL I JSYSRS, 'DOS. SYSRES. FILE' 

// EXTENT SYS 00 5 

// DLBL IJSYSCL, 'DOS. PVT.CIB. FILE' 

// EXTENT SYS 007 

// DLBL IJSYSRL, 'DOS. PVT.RLB. FILE' 

// EXTENT SYS 00 8 

// DLBL IJSYSSL„ 'DOS.PVT.SLB.FILE' 

// EXTENT SYS009 

MTC REW,SYS006 backup does not rewind at OPEN or CLOSE 
// EXEC BACKUP 
/g 
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fiote: For the description of the standalone backup and restore, refer to BQS^V§ Sigteg 
Utilities. 

If several private libraries are to be backed up,, you iray execute BACKUP several times 
to place these libraries on the same tape. These libraries may be restored with RESTORE 
which must be executed the same number of times as BACKUP was executed. If you use the 
standalone Restore program, you must forward space the tape two files to bypass one 
execution of BACKUP. 

Figure 1-17 shows (1) the library identifiers to be used in the &LLOC statements for a 
later restore run and (2) the associated logical units and file names. 



r T 

I Identifier j library 



■T 1 1 

iLogical Unit | File Name | 



CL 1 System Core Image Library | SY5 00 5 | IJSYSRS 
RL 1 System Relocatable Library | SYS005 j IJSYSRS 
SL I System Source Statement Library | SYS 005 | IJSYSRS 
PL I System Procedure Library | SYS005 | IJSYSRS 
PC j Private Core Image Library 1 SYS 007 | IJSYSCL 
PR I Private Relocatable Library | SYS008 1 1 JSYSRL 
PS [Private Source Statement Library | SYS009 | IJSYSSL 
X X X 



Figure 1-17. 



Library Identifiers « File Names, and Logical Units for 
the BACKUP and RESTORE Utility 



Step © Restore the Syste m 

To restore the system and also your private libraries, use the job stream given in Step 
2. On completion of the job, all libraries are condensed. 

Step (E) Merging User Programs 

Use the CORGZ program to merge the contents of an existing system residence disk pack 
with the contents of a new system residence disk pack, retaining the existing members of 
the destination library if duplicates occur. The control statements needed for this 
operation are: 



// JOB MERGE 

// DLBL IJSYSRS, »DOS,SYSRES. FILE* 

// EXTENT SYS002 

// ASSGN SyS002,X»161« 

// EXEC CORGZ 

MERGE RES,NRS 

COPYC NEW 

COPYS NEW 

COPYR NEW 

COPYP NEW 



new SYSRES 

device for new SYSRES 



Provide COPYx statements as required. 
At least one COPYx 
statement must be given. 



For further information on the CORGZ program, refer to D0§^V2 Sigteg Control Statements. 

Note: Phases $$A$SUPx, if contained in the current CIL directory, will not be merged to 
the new CIL directory. Such phases are assumed to be supervisors and must be compiled 
again on the new system. Phases $$BFCBxx, $$BUCBxx, $J0BACCT, and SSYSOPEN, if found in 
the current directory, are merged to the new CIL directory even if they are present 
already. 

s tep ^ Assemble I/O Modules 

Perform all other necessary assemblies. A- library macros such as, for instance, licensed 
programs supplied in A-macro format, must be edited before they can be assembled. The 
component assemblies should be performed as separate jobs. 
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For the information required to assemble Emulator Programs, refer to the Emalator 
Program manual listed in the Preface. ~ 

Assemble all your required IOCS modules. By assigning SYSPCH to a tape unit, disk 
extent, or diskette extent, the IOCS modules can be cataloged to the relocatable library 
without punching them in cards. The IOCS modules required by compilers, as defined in 
"Module 7: Compiler IOCS Modules", are contained in the IBM-supplied relocatable 
library. 

Close the tape assigned to SYSPCH and reassign SYSPCH to its permanent assignment by 
using the CLOSE coniinand . The asseirbly listings should be checked for errors before 
proceeding. 

Note ; Do not include a START statement in your assembly. 

Given below is a sample job stream for the assembly of a CDMOD and MTMOD I/O module. 

r " 

// JOB ASSEM 

// OPTIOISI DECK,, LIST, LOG, NOXREF 

// ASSGN SYSPCH,, X' 280' 

// EXEC ASSEMBLY 

PRINT NOGEN 

CDMOD RECF0RM=FIXUNB,CTLCHR=ASA,TYPEFLE=0UTPUT,I0AREA2=YES, X 

DEVICE=3 52 5 , SEPASMB=YES 
END 
/* 
// EXEC ASSEMBLY 

PRINT NOGEN 

MTMOD RECFORM=FIXBLK,, READ= FORWARD, SEPASMB=YES 
END 
/* 

CLOSE SYSPCH, X' OOD* 
/£ 

♦Check asserrbly listings for errors. Reload 280 with same tape. 
// PAUSE if correct press end to continue 

The multipart forms of the linkage editor maps and the supervisor listing will be 
required by your IBM customer engineer for maintenance purposes. 

Before the next step is performed, check the linkage editor listings, and make all 
necessary corrections. 



Step <^ Catalog IOCS Modules 

This step can only be executed in the background partition of the system. 

Reload the tape that was assigned to SYSPCH in Step 11 and assign it to SYSIPT- Witn 
this tape the MAINT program catalogs the IOCS modules to the relocatable library. 

r ■ 1 

I // JOB CATALRLB 

|// ASSGN SYSIPT, X' 280' 

1 * CATALOG MODULES TO RELOCATABLE LIBRARY 

|// EXEC MAINT 

|/6 

L - 

The basic SYSGEN is complete. You may set new standard labels, reallocate library sizes 
by using the copy function (COEGZ) , condense the libraries, and" set condense limits if 
required. Copy the operational pack for backup. 
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step (B IPL New S YSRE S 

Perform IPL and format your new page data set using the IPL DPD command including 
TYPE=F. To improve system performance, set up an SVA and build an SDL. You may use one 
of the IBM-provided procedures for this purpose (see "Introduction" in this module) , or 
specify the phases whose names are to be included in the SDL by submitting a SET 
SDL=CEEATE command (see the example below) , If you do not wish to retain a procedure 
library, you should punch out the procedure, using the PSEEV program, and include it in 
your set of IPL commands. 

Example ; 

ADD commands (optional) 

SET DATE etc. 
DPD options 
SET SDL=CEEATE 
phase name 

/* 

ASSGN commands 
SET RF=CREATE 

The IBM-provided procedure (or the command SET SDL=CEEATE) must precede job control 
commands such as ASSGN. These procedures can be executed only in a multiprogramming 

environment (NPAETS>1) . 

When IPL is complete, enter the SET job control command to create the recorder file. 
If your CPU is equipped with a display operator console, include HC=CREATE in the 
coinmand to cause the creation of a hard copy file. For more information on these 
procedures, refer to DOS/VS System Management Guide > 

step C£? Standard L abels and Ha rdcopy File 

Define label information for SYSRES, SYSLNK, SYSREC, SYSOOl, SYS002, and SYS003. In 
addition you may include any label inforiration required for your installation. If your 
system resides on a 3330, 3340 Model 70, or 3350 you may use the provided procedure 
LABELS30, LABELS40, or LABELS50 respectively, to load the default standard labels, or you 
may define your own standard labels as follows: 

J. ^ 

// OPTION STDLAEEL 

// DLBL IJSYSRS,'DOS SYSRES . FILE *, 99/36 5, SD 

// EXTENT SYSRES, nnnnnn,l,n, 0001,, nnnn 

// DLBL IJSYSLN,' SYSTEM WORK FILE NO. 0», 99/365, SD 

// EXTENT SYSLNK„nnnnnn„l„n,nnnn,,nnnn 

// DLBL IJSYSOl," SYSTEM WORK FILE NO. 1*, 99/365, SD 

// EXTENT SYSOOl, nnnnnn,l,n,nnnn,nnnn 

// DLBL IJSYS02,* SYSTEM WORK FILE NO. 2', 99/365, SD 

// EXTENT SYS002,nnnnnn,, l,n,nnnn,nnnn 

// DLBL IJSYS03,' SYSTEM WORK FILE NO. 3',99/3 6 5, SD 

// EXTENT SYS003,,nnnnnn,l,n,nnnn,nnnn 

// DLBL IJSYSRC'DOS RECORDER FILE' , 99/365, SD recorder f J le 

// EXTENT SYSREC,nnnnnn,l,n,nnnn,nnnn 

// DLBL IJSYSCN, 'HARDCOPY FILE' , 99/365, SD hard copy file 

// EXTENT SYSREC, nnnnnn,l„n^nnnn,nnnn 



// DLBL IJSYSIN,'DTTEPTF'„ ,DU 

// EXTENT SYSIN 

// EXTENT SYSIN 

// EXTENT SYSIN 

/& 



SYSIN labels for 
diskette PTF for 
cardless systems 
only 



In addition « you nay now perforn an LSEEV and an LVTOC to obtain a listing of the labels 
stored on the label cylinder (s) and in the VTOC. 

// JOB DISPLY 

// EXEC LSERV 

// ASSGN sys004,X'160' for your systeiri residence pack 

// ASSGN SYS005,,X' OOE* for the printer 

// EXEC LVTOC 

/£ 

Step (§ DSERV and Link PTFHIST 

Perforin a sorted DSERV to display the directories for later reference using the following 
statements: 

// JOB DSERV 
// EXEC DSERV 

DSPLYS ALL 
/£ 

Initialize and link the Maintain System History (PTFHIST) Utility (see also section 
"Utilization of the Maintain System History (PTFHIST) Program" earlier in this module) 
using the following statements: 

// JOB PTFHIST 
// OPTION DECK 
// EXEC ASSEMBLY 

HIST for parameters, see "HIST Macro Description" 

END in "Module 24: System Utilities". 

/+ 
/£ 

Execute the job stream generated on SYSPCH. 

Step (D Assemble IVP 

Perform an assembly of the Installation Verification Procedure. The output consists of a 
job stream to execute the selected IVP functions. Output is on SYSPCH which can he a 
card punch, a tape drive, a disk drive, or a diskette. You can also generate a job that 
deletes the IVP books that were used in the assembly. If you choose to do this,- however, 
bear in mind that it will be impossible to do a reassembly of the IVPGEN macro during 
this system generation. 

Refer to "Module 3: Installation Verification Procedure" for a comprehensive 
description of the operating instructions for IVP. 

r 1 

|// JOB IVP GENERATION 

]// EXEC ASSEMBLY 

I IVPGEN VERIFY=NO, [DELUSED=YES,] selected IVPGEN parameters 

I END 

|/* 

]// PAUSE the output on SYSPCH must now be read on SYSIN 
l/S 

L 

Step (E" Backup Libraries 

Now you should take a backup by using the Backup or FASTCOPY programs as shown in Step i 
of this example. 

Unsuccessful Generat ion 

If the generation proved unsuccessful, repeat the appropriate job step or call your IBM 
representative. 
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DOS/VS System Program Sizes and Component Storage Requirements 



Cornponent 



IBM 

Program 
Number 
5745-SC 



Core Image 
Phases 



Library 



Blocks 



Relocatable 
Library 



Prefix Blocks 
Modules 



Source 
Statement 
Library 



Books Blocks 



Attention Routines,, 
Initiators^, 



AIT 
(Note 1) 



Terminators 6 Dumps 



Standard System Dixnp 

Translating System 

Dump 

Attention Routines, 

Initiators, 

Terminators 



11* 
11* 



33* 



13 
13 



38 



IJB 12 70 
UB 12 71 



Assembler £ ESERV 



Programs 

Assembler 

ESERV 



ASM 
(Note 2> 



2 
(IVP) 



19 

7 



122 
41 



IPKA 38 609 
IPKV 10 218 



U4 



BTAM 



BTM 
(Note 2) 



52 
29* 



52 
37 



IJL 65 179 



66 



8620 



Checkpoint/ 
Restart 



CKR 
(Note 1) 



14* 



22 



26 



Direct Access (Disk) 
IOCS 



DAM** 
(Note 2) 



11* 



12 



IJI 28 246 



1273 



^ 

50 3 



Diskette I/O Unit 



DIO 



19* 
6* 



19 
6 



Disk ERP 



DKE 
(Note 1) 



411 

407 



Display Operator 
Console Support 
(PSIMTLOG) 



DOC 
(Note 1) 



31* 

1 



31 
5 



IJB 



20 



Sequential Disk 
IOCS 



DSK»* 
(Note 2) 



30* 



30 



IJG 55 344 



11 



6648 
^ 



Emulators 



1401/1440/1460 
Emulator 
1410/7010 
Emulator 
^ 

Model 20 Emulator 

Environmental Re- 
cording,, Editing^ 
and Printing (EREP) 



5747-eC3 



(Note 2) 



-+ 



E20 
(Note 2) 

ERP 
(Note 2) 



25* 

7 



40 

7 



IIS 73 506 



23 






1* 
131 



IJB 



127 1632 



2471 
^ 






344 






Figorc 1-18. Library B«qiilr«B«nta (Part 1 of 4) 
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T T 

Core Image Library 
Phases Blocks 



T n 

Source 
StateiTient 
-^ Library 



Component 



IBM 

Program 
Number 
57U5-SC 



■i 



+- 



Relocatable 
Library 



Prefix Blocks 
Modules 



Books Blocks 



Compiler IO CS 
Modules 



lOM 
(Note 2) 



32 + 



108 



CCBOL 
PL/ 1 



ANS*** COBOL 
AMS**+ COBOL S 
ANS*** COBOL 6 
ANS+** COBOL, 

COBOL, and PL/I 
COBOL 

COBOL and PL/I 
PL/ 1 
RPGII 

Required IOCS 
Modules 



Note: This program 
consists of a 
group of various 
preassembled IOCS 
modules used by 
American National 
Standard COBOL, 
PL/I, and COBOL. 
The digits given 
here represent 
the number of mod- 
ules used and the 
number of library 
blocks required by 
the various comibi- 
nations of compi- 
lers desired. 



226 


1388 


148 


991 


163 


1181 


169 


1100 


341 


1272 


77 


578 


107 


698 


70 


412 


161 


876 


27 


100 



-+- 



+- 



IOCS (see Note 2) 



lOX** 



60 + 



61 



Card (Reader/Punch) 

Console 

Device Independent 

(DTFDI) 

Printers 

Serial Devices 

PIOCS (DTFPH) 

DTFBG 

DTFEN 

Imperative Macros 

Rotational Position 

Sensing 



(Note 1) 



IJC 


64 


154 


2 
1 


851 
127 


IJJ 


6 


31 


2 


331 


IJD 


22 


50 


2 
1 

1 
1 

1 
28 


535 

66 

66 

2 

24 

428 



RPS 



34 



110 



IPL and Buffer 
Load 



IPL 

(Note 1) 



12* 
6 



12 

24 



IJB 



20 161 



22 



Index Sequential 
Disk IOCS 



ISM+* 
(Note 2) 



26* 



34 



IJH 



45 902 



2717 



Job Control 
Librarian 



JCL 
(Note 1) 



3 + 
13 



4 
70 



IJB 



11 310 



245 



CORGZ 

MAINT 

CSERV 

DSERV (sorted) 

RSERV 

SSERV 

PSERV 



LBR 



(Note 1) 



9 
11 
1 
6 
1 
1 
1 



43 
63 

6 
13 

7 



IJB 


10 


162 


IJB 


19 


305 


IJB 


1 


24 


IJB 


2 


61 


IJB 


2 


29 


IJB 


2 


37 


IJB 


1 


25 



-+ 



Linkage Editor 



LNK 
(Note 1) 



20 



IJB 



87 



Magnetic Character 
Reader IOCS 



MCR** 
(Note 2) 



8* 



278 



Figure 1-18. Library Requirements (Part 2 of 4) 
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2 


i 

1 
1 








5 




1 Reader IOCS 
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2* 


2 
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6 
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2* 
48 
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91 
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1 


IJZ 


50 
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IJB 
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1 


24 
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1 
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1 
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1* 
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IJB 


3 
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1 


2 


1 


IJB 


1 
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_ X 
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1 






T 




1 


j Paper Tape IOCS 
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4 


-+- 






+- 


2 
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H 
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H5 

1* 
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1 
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13 
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1 
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22* 


34 




IJL 
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X 


79 
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1 
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23 
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+ 




1 
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2 
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T~ 




1 
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18 
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2 
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i: 
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Library 
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Books Blocks 
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1ST 



44 



4680 
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17 1 


IJW 


2 


67 


18 1 


IJW 


5 


59 


28 1 


IJW 


5 


122 


15 1 


IJW 


5 


69 


5 ! 


IJW 


2 


23 


16 1 


IJW 


1 


63 


7 1 


IJW 


2 


33 


8 1 


IJW 


2 


35 


6 1 


IJW 


4 


34 


1 1 









(Note 1) 



482 



522 



« Maintain System 
\ History 

; List Systen History 



UTS 



, I- 

• i 3800 _P r inter Support 



56 
12 



IKR 
I KB 



128 
63 I 



+■ 



85 



[EBIM/\GE 

GRFlxx-:x 

aTB 1 xxxjc 

SETPP? 



5748- 
C1-IMP 



1 

15 
47 






15748- I 
|C1-PRT j 

Analysis Program-l jAPC | 

i.. _L 1 . 

« Ti anoi ents 

'?•» see "Compiler IOCS Modules" 
>*« ';ii!f^ li can National Standard 



29 
35 
47 

14 



lEB 


4 


111 


GRF1 


15 


131 


XTB1 


47 


188 



! IJV 



70 



19 i lAQ 4 9I» I 
J J 



275 
1 



H 



for the preassembled module names and usage. 






'i.SiUi<S 



18. Library Hfeguireiafents {Part 4 of 4) 



uOa/ii. cJyGteffi Generation 



Notes ; 

1. See subsequent sections for further information on this component. 

2. See the relevant separate book module for further information on this component. 

3. This is the formula to calculate the number of core image library blocks needed for 
the configuration data sets: 

number of devices on system + 1 = number of blocks 
6 

U. The number of core image library blocks required for the Online Tests (OLTs) depends 
on the number of device types on the system and the number and size of the tests 
needed for these devices. This information is in the description that accompanies 
the tests. 
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Component Requirements 

IOCS Routines 

SOURCE S TATEMENT LIBRARY 

The following macros are shipped in the source statement library. 

Note : "Module 7: Compiler IOCS Modules", contains a list of preasseitibled modules 
required by system programs. 

File Definition Macros 



E.CDMOD 
E.DTMOD 
E.DTFBG 
E.DTFCD 



E.DTFCN 
E.DTFDI 
E.DTFEN 
E.DTFPH 



E.DTFFR 
E.DTFPT 
E.DTFSR 
E.PRMOD 



Imperative Macros 



Storage Bytes 





Basic 




lE.CCB 


16-24 




|E. CHECK 


8 




|E. CLOSE 


10 




|E. CLOSER 


14+10 


if any 


lE.CNTRL 


10-18 




lE.ERET 






lE.EXCP 


2-6 




lE.FEOV 


8-12 




lE.FEOVD 






lE.FREE 


8-12 




1 E, GET 


8 




]E.LBRET 


2 




lE.NOTE 


12 




|E,OPEN 


10 




lE.OPENR 


14+10 


if any 


lE.POINTR 


8 




|E. POINTS 


8-12 




lE.POINTW 


8 




1 E. PRTOV 


8 




j E . PUT 


8-12 




lE.READ 


8-36 


Note 5 


|E. RELEASE 






lE.RELSE 


8 




lE.SECTVAL 


10 




|E. SEOV 


10 




jE.TRUNC 


8-12 




lE.WAITF 


8-12 




|E. WRITE 


8-26 


Note 5 


L 


L 




Notes: 







register is specified 



register is specified 



i For Li t erals (Note 1) 

I 

1 

1 + 4 

1+8 

1 + 8 

1+4 

1 

1+0-4 
i + 4 

I 

1+0-4 

1+4 per symbolic name 

I 

1+4 

1+8 

1+8 

1+4 per symbolic name 

1+4 

I +4 per symbolic name 

1+4 per symbolic name 

1+4 

1+4 per symbolic name 

I 

1+4 per symbolic name 

I +4 per symbolic 

1 + 8 

1+0-4 

1 + 0-4 

1+0-4 



|For Variables 


1 Note 


2. 


|Note 


3. 


[Note 


4. 


INote 


2. 


1+2 




[Note 


3. 


|Note 


4. 


|Note 


2. 


[Note 


2. 


|Note 


2. 


INote 


2. 


iNote 


6. 


1+3 




jNote 


3. 



1. Include the storage requirement for literals only once if the literal is used by more 
than one macro instruction. 

2. +4 per symbolic name, +2 per ordinary register notation* or +0 per special register 
notation. 

3. +4 per filename or +8 per register. 

4. +14 per filename or +8 per register. 

5. 2 bytes are required for BTAM. 

6. +38 No operands coded in register notation. 
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IOCS Macro Storage Recfuirements 



The storage required by the imperative macros may be determined by using the preceding 
figures with Figures 1-19 through 1-23, 

Note: Read-only modules are recommended for virtual programs (RDONLY=YES) . 

CDMOD (CARD MODULE) 









r 




TYPEFLE 


" 












L _ 
















1 INPUT 1 




OUTPUT 


1 


CMBNE 


j 








+ — T +- 








J 






r~ 

1 RECFORM 


1 


I0AREA2 1 


WORKA 1 1442 | 2560*| 


1442 1 


2520 1 


254012560* or 5425) 


1442 1 


2520 1 








1 2520 1 5425 ] 
1 2540 1 1 


2596 j 




'^^7'^\ 


J 


1 


2540 1 










1 For 1 


1 

For 1 


1 
1 








1 2501 1 1 






] Punch 1 Punch | 


1 










1 2596 1 1 






|File 1 Inter-] 


1 










1 3505 1 1 






1 Ipret 1 


1 










1 3525 1 1 






1 iFile 1 


1 






-+- 


+- 


1 3881 1 1 
^ + ^._ 

- 1 104 1 154 1 


+- 

74 1 


+- 

80 1 


1 1 

+ +- 

40 1 104 1 


+- 

96 1 


1 
+- 

126 1 




1 FIXUNB 


198 1 


1 FIXUNB 


-f- 


+- 

+- 

YES 1 


1 + ^. 

YES 1 106 1 160 1 
^ 1 ^_ 

- ! 136 1 176 1 


+- 

116 1 
+- 

118 1 


+- 

122 I 

+- 

124 1 


+ +- 

84| 134 1 

+ +- 

82| 140 1 


+- 

122 1 
+- 


+- 

154 1 

+- 

126 1 


226 1 


1 FIXUNB 


198 1 


1 FIXUNB 


-f- 


+- 

YES 1 


+ + +_ 

YES 1 138 1 186 1 


132 1 


+- 

138 1 


96| 150 1 


+- 


+- 

154 1 


226 1 


1 UNDEF 


-+- 


+- 


- 1 - 1 - 1 


— +- 

112 1 


f- 

110 1 


+ +- 

73| 125 1 


+- 


+- 

- 1 


— 1 


1 UNDEF 




+- 

+- 

YES 1 


YES 1 - 1 - 1 
- 1 - 1 - 1 


+- 

124 1 
+- 

128 1 


+- 

132 1 
+- 

130 1 


+ +- 

92 1 142 1 

+ +- 

90| 148 i 


+- 

+- 


f- 

- 1 
+- 

- 1 


- 1 


] UNDEF 


- I 


1 UNDEF 


-•f- 
-f- 
-+- 


+- 

YES ! 
+- 

+- 

+- 

YES I 

+- 

YES 1 


K 1 1 K 1 t k! 1 
W t 1 1 W 1 1 1 H 1 
CO 1 1 CO 1 1 CO 1 

1 1 1 1 t 1 1 1 t t 

1 1 < 1 1 1 1 1 1 1 
1 1 t 1 1 

1 1 1 1 h 

1 t 1 1 1 


+- 

140 1 
+- 

126 I 
+- 

140 1 
+- 

154 1 
+- 

156 1 


+- 

146 1 
+- 

132 1 
+- 

146 1 
+- 

160 1 
+- 

162 1 


+ +- 

104| 154 1 

+ +- 

94| 142 1 
+ +- 

108| 164 1 
+ +- 

1181 166 1 
+ +- 

120 1 176 1 


+- 

+- 

+- 

-H- 


1 1 1 1 1 1 1 1 1 1 

— 1 1 1 1 y- 

1 1 1 1 1 


- 1 


1 VARUNB 


- 1 


) VARUNB 


- 1 


] VARUNB 

L 


- 1 


r 

1 VARUNB 


- j 


L 


1 


i 


i X i 


X - 


J 


X X- 


X 


X 


J 




space req 


uired for associated f 


iles: 
















FUNC= 


T 
1 TYPFLE 


1 

1 
















L 


X 


J 








r 


1 INPUT 1 OUTPUT I 














1 _ 


X J- - 










r ~ 
RP 


t T 

1 48 1 


56 1 














[ 

RW 


1 56 1 


~: — "1 
















[ 

PW 

L _ 


--h i 

1 - 1 

X 4- - 


48 1 








RPW 


T t 
1 92 i 


64 1 














L 


_J. L 









Figure 1-19. CONTROL — CDMOD Storage Requirements (Part 1 of 3) 
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Notes ; 

1. CTLCHR=YES or ASA; depending upon record format, number of I/O areas, and/or work 
area specifications: 

For YES,, a minimum of 8 to a maximum of 36 additional bytes are required. 

For ASA, a minimum of 28 to a maximum of 65 additional bytes are required. 

2. RDONLY=YES changes the size of the modules -50 to +50 bytes. In addition, the user's 
program must provide a 72-byte save area each time the module is reentered. 

3. Parts 2 and 3 of Figure 1-19 show the requirements for the other CDMOD options. The 
values selected must be added to the TYPEFLE value to determine the amount of storage 
needed. 



r T 

I CRDERR=RETRY 

|. + 

I without IOAREA2 or WORKA | 
^ + 

I with either or both | 

L J. 



1 2520 I 2540 | 

+ ^ 

+73 I +123 I 
+ -I 

+69 1 +119 I 

L J 



Figure 1-19. CONTROL — CDMOD Storage Requiremients (Part 2 of 3) 



T 1 

3505/3525** 



CONTROL=YES 



1442 



2540 



2520 



2560* 
or 5425 



INPUT 



+26 



+ 82 



+ 30 



+ 44 



+ 94 



OUTPUT without WORKA 



+ 24 



+ 20 



+12 



+ 36 



+ 26 



OUTPUT with WORKA 



+24 



+ 32 



+ 12 



+ 20 



+ 38 



CMBND without WORKA 



+ 24 



+ 20 



+12 



CMBND with WORKA 



+ 32 



+ 32 



+12 



♦CONTROL may not be specified for input files associated with punch 
files on the 2560 or 5425. 
++CONTROL may not be specified for input files used as associated files 
on the 3525. 

J 



Figure 1-19. CONTROL — CDMOD Storage Requirements (Part 3 of 3) 

DTFCD (DEFINE THE FILE CARD ) 

TYPEFLE=INPUT requires 50 bytes. (72 bytes for single file for a 2560 or 5425, 56 bytes 
if ERROPT is specified for a 3 50 5 or 352 5,, 82 bytes plus the length of the card buffer if 
ASOCFLE is specified for a 2560 or 5425, 60 bytes if ASOCFLE is specified for a 3525.) 

TYPEFLE=CMBND requires 8 4 bytes. 

TYPEFLE=OUTPUT requires 48 bytes (64 bytes for single file for a 2560 or 5425, 69 bytes 
plus the length of the card buffer if ASOCFLE is specified for a 2560 or 5425, 52 bytes 
if ASOCFLE is specified for a 3525, 152 bytes if FUNC=I is specified for a 2560 or 5425, 
128 bytes if FUNC=I is specified for a 3525). 

CRDERR=RETRY (2540 only) requires an additional 88 bytes. 

DEVICE=2520 requires 8 additional bytes. 



110 DOS/VS System Generation 



Page of GC33-5377-6, Revised November 28, 1977, By TNL GN33-9230 

DIMOD (DEVICE INDEPENDENT SYSTEM UNITS MODULES) 

r T T T 1 

I I Basic I I I 

I TYPEFLE= I Module | I0AREA2=YES | RPS Version of Logic Module | 

|. 1 4- ^ ^ 

I INPUT I «54 I +112 I 534 | 

^ f + + ^ 

I OUTPUT I 903 I +152 | 1021 j 

i. ± X X ^ 

1RD0NLY=YES changes the size of the module -70 to +70 bytes. In addition, the | 

I user's program irust provide a 72-byte save area each time the module is reentered, j 

IRPS versions of the logic jnodels support all other options for each TYPFLE. | 

I I Specif ying TRC=YES adds another 256 bytes to the size of the module. j 

L J 

Figure 1-20. DIMOD Storage Requirements 

DTFDI (DEFINE THE FILE DEVICE INDEPE ND ENT SYSTEM UNI TS) 

The table requirement is 2U0 bytes. 

PRMOD (PRINTER MODULE) 



T T T T T r r 

III I |CTLCHR= I i 

I BASIC I I I ^ T — ^ I 

RECFORM= I MODULE | WORKA=YES | I0AREA2=YES j PRINTOV |ASA | YES | CONTROL=YES | ERROPT=YES 
I (2) I I I (3) I I I (U) I (1) 





--+- 




-+- 





--+— 




— f- 




--+ + +~ 





+- 




FIXUNB 


1 
J. . 


72 


1 

L _ 


+ 6 


1 

_ I 


+ 24 


1 

X 


+ 34 


1+1281 1 
_ X _ ; X 


+ 40 


1 

1 


+ 68 




— T 




— r 




T 




T 




T 1 T 




— T 




UNDEF 


1 

-4- 


102 


1 
-+- 


+ 22 


1 


+ 12 


1 


+ 34 


1+1321+4 1 
--+ + +~ 


+40 


1 


+ 68 


VARUNB 


1 
J 


136 


1 

X 


+m 


1 

X 


+12 


1 

X_ 


+ 34 


1+1241-4 1 

X X X 


+ 40 


1 
X_ 


+ 68 



Note ; RDONLY=YES changes the size of the module -50 to +50 bytes. In addition, 
the user's program must provide a 72-byte save area each time the module is 
reentered. Specifying TRC=YES increases the size of the module by an additional 
102 to 158 bytes, depending on the options chosen. 

(1) If ERROPT=YES is specified, then DEVICE=3211 must also be specified. For a 
352 5 add 22 bytes, instead of 68, for ERROPT. 

(2) For the 2560 and 5425, the sizes are 166 bytes for FIXUNB, 190 bytes for 
UNDEF, 206 bytes for VARUNB. For the 3525, add from 52 to 72 bytes to the 
size of the basic module, depending on the type of associated file specified. 

(3) For the 3525 add from 34 to 58 bytes. 

(4) For the 352 5 add from 40 to 160 bytes. 



Figure 1-21- CONTROL — PRMOD Storage Requirements 



DTFPR (DEFINE THE FILE PRINTER) 



The table requirement is 4 8 bytes or 52 bytes if ERROPT is specified for the 3211 printer 
or, if ASOCFLE is specified, for the 3525 card punch. For the 2560 the requirement is 72 
bytes for a single file or 64 bytes for an associated file; for the 5 425 the requirement 
is 56 bytes for either a single or an associated file. 
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DTFPH (DEFINE THE PHYSICAL IOCS) 



Device 



h 

I Tape 



|Size 



101 



y 

jDASD M011NTED=ALL 



'♦O 



|. 

JDASD MOUNTEE=S INGLE 



84 



35U0 MOUNTED=SINGLE 



^- 
I 

Y X. 

jNo module is required for this macro 
I instruction. 

L 

Figure 1-22. CONTROL — DTFPH Storage 
Requirements 



84 



DTFCN 


(DEFINE 


THE 


FILE 


CONSOLE) 








1 

1 
-+ 


TYPEFLE= 



|RECFORM= |WORKA= | INPUT/ | OUTPUT | CMBND| 
1 I I OUTPUT I only | | 

IFIXUNB I - I 94 I 60 | 144 

IFIXUNB I YES I 150 | 90 | 252 

jUNDEF I - I 166 I 114 I - 

jUNDEF I YES | 262 | 168 \- 

i X i. X 



h -^ 

I No module is required for this macro | 

{instruction. | 

L J 

Figure 1-23. CONTROL — DTFCN Storage 
Requirements 



DTFSR (DEFINE THE FILE SERIAL DEVICE) 

Uhen a DTFSR is assembled, it generates 
both a table and a module. For example, if 
DTFSR is used for a printer, a table and a 
module are generated just as though DTFPR 
and PRMOD were used. To determine the 
storage requirements for DTFSR, add the 
table and the module requirements for the 
appropriate device type, such as 48 bytes 
(DTFPR) and n bytes (PRMOD) for a printer. 



System Directory list and SVA L4Muiing 



• SDL loads a set of selected system 
phases, but no RPS or VSAM phases. 

• RPS loads the same phases as procedure 
SDL plus RPS phases. 

• VSAMSVA loads the same phases as 
procedure SDL plus VSAM phases. 

• VSAMRPS loads the scune phases as 
procedure SDL plus RPS and VSAM. 

The statements that make up procedures SDL 
and RPS are listed under "SDL Considerations' 
and "RPS Considerations", respectively, 
below. Those of VSAMSVA and VSAMRPS are 
listed in Module 17 of this manual, under 
"Loading VSAM phases into the SVA". 

If a 3800 Printing Subsystem is to be used, 

names IJVSPRDV and IJDPR3 must be added to 

the SDL. They are not in any of the IBM- 
supplied lists. 



SDL CmisideratHms 



Procedure SDL builds a system directory 
list for systems generated without VSAM and 
RPS support. It consists of the following 
transients, phases, and statements: 



SET SDL=CREATE 

$$BCLOSE 

$$BCL0S2 

$$BCL0S3 

$$BCLOS4 

$$BEOJ 

$$BE0JS1 

$$BEOa4 

$$BEOJ7 

$$BOCP01 

$$BOCP03 

$$BOFLPT 

$$BOP£N 

$$BOPEND 

$$BOPENR 

$$BOPEN0 

$$BOPENl 

$$B0PEN3 

$$B0PEN4 

$$B0PEH5 

$$B0P£li6 

$$BOPIGN 

$$B0SDC1 

$$BOSDC3 

$$B0SDI1 

$$B0SDI2 

$$B0SDI4 

$$B0SDOl 



$$B0SDO2 

$$B0SD03 

$$B0SD04 

$$B0SD08 

$$B0SD09 

$$B0SDW1 

$$B0SDW2 

$$BOSD00 

$$BOSD01 

$$BOSD02 

$$ BOS DO 3 

$$BOSD04 

$$BOSD05 

$$ BOS 006 

$$BOSIGN 

$$BSETL 

$$BSETL1 

$$BSETL2 

$JOBCTLA 

$JOBCTLE 

$JOBCTLN 

$JOEACCT» SVA 

$JOBEXIT,SVA 

$LIESTAT,SVA 

$MAINDIR,SVA 

/♦ 

/♦ 



The system procedure library contains the 
procedures SDL, RPS, VSAMSVA^ and VSAMRPS 
to build system directory lists and to load 
IBM'SUpplied phases into the SVA. 
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RPS Considerations 



Procedure EPS builds a system directory 
list for systems generated with EPS 
support. This procedure consists of the 
statements given under "SDL Considerations" 
(excluding the /* and /♦) plus the 
following: 

IJGCYCSb^SVA 

iJtiCYC«B,S/A 

IJGFiCaB^SVA 

iaGFWC«B,SVA 

IJGFXCrtB,SVA 

IJGFJCCiia,SVA 

IJGPYC»B,S¥A 

IJGQirfCi<B,Si?A 

IJGQXCSfB,S?A 

iJGRi:Ci»B,S/A 

IJGS3fC«B,S¥A 

XJGTWNCT,S¥A 

lJGOirC»a,S/A 

IJGUXCi^B,S*?A 

IJGVWCwB,S¥A 

IJG¥XCWfl,StrA 

IJHAVBBF,SVA 

IJHAVBBS,SVA 

IJHAVBCF,SVA 

IJHAVBCS,SVA 

IJHAVGBF,SVA 

IJHAVG.BS,SVA 

IJHAVGCF,SVA 

IJHAVGCS,SVA 

IJHZXGZS,SVA 

IJIBWEHW,SVA 

lJiFMEri«,SVil 

IJISWEHW,SVA 

IJlVW2Hi,S¥A 

IJJCVA1N,SVA 

IJJCVDV,SVA 

IJJCVDO,SVA 

IJJFVBIC,SVA 

UaFVIICSVA 

/* 

/♦ 



5I£ETI0N OF SPS SUPPORT 

If RPS support will never be wspd^ in any 
supervisor, the following core image library 
phases may be deleted: 

IJGCYCMB 

IJGCYCWB 

IJGFWCMB 

IJGFWCWB 

IJGFXCMB 

IJGFXCWB 

IJGPYCWB 

IJGQWCWB 

IJGVXCWB 

IJGRYCWB 

IJGSYCWE 

IJGTWNCT 

IJGUVgCWB 

IJGUXCWB 

IJGVWCWB 

IJGQXCWB 

IJHfiVEBF 

I JHAVBB S 

IJHftVBCF 

IJHAVBCS 

IJHAVGBF 

IJHAVGBS 

IJHAVGCF 

IJHAVGCS 

IJHZXGZS 

IJIBWEHW 

IJIFWEHVJ 

IJISWEHW 

IJIVWEHW 

IJJCVAIN 

IJJCVDV 

IJJCVCO 

IJJFVBIC 

IJJFVIIC 



Module 1: Planning and Procedures 113 



2S5::ItQ*2IllG modules in tH£ sh 

Any or all of the following modules may be pre-loaded into the SVA to improve 
performance. When checkpointing with RPS in the system it is a requirement that any RPS 
logic module phases that will be used by the program be pre-loaded. Any access method 
may be used Mhen all of the following phases are pre*loaded. For inforniation on 
reserving storage for EPS, refer to the DOS/VS System Management Guide. 













T 

j Huaber I 


Phase Name] Access 


He t hod 


1 Function 

L^ .<^^.^4B-^^aiW«N«M-^^^«».^«a ^m -^ -mm ^ -m^ -^m ^ -m- 


|of Bytes j 

. ■ A— i 


IJGCICnB 


r— 

Seguem 


bial Disk 


1 Fixed length, update, TSUSCS 


1550 1 


IJGCYCWB 






[Fixed length, update 




[ 1406 I 


IJGF«CMB 






1 Fixed length, input, TRUNCS • 


1078 1 


IJGFHCKB 






1 Fixed length, input 




90U 1 


IJGPXCMB 






[Fixed length, output, TRUNCS 


1252 1 


IJGFXCHB 






1 Fixed length, output 




i 1032 ) 


IJGPYCWB 






1 Spanned record, update 




1 3302 1 


IJGQHCMB 






1 Spanned record, input 




1428 1 


IJGQXCWB 






[Spanned record, output 




2790 1 


IJGRYCWB 






1 Undefined, update 




1518 t 


IJGSYCWB 






[Variable length, update, 


hold 


1778 1 


IJGTWNCt 






[Hork file 




1992 1 


IJGUHCHB 






1 Undefined, input 




928 1 


IJGOXCtfB 






lOndefined, output 




1090 1 


IJGVHCSB j 






[Variable length, input 




998 1 


IJGVXCWB 






[Variable length, output 




1568 1 


IJHAVBBF 


lISAfl 




jHOLD, CORD ATA 


1 


7744 I 


IJHAVBBS 






[HOLD, no COBDATA 




7234 1 


IJHAVBCF 






I No HOLD, CORDATA 




7330 1 


IJH&VBCS 






|NO HOLD, no COEDATA 




6812 ! 


IJHAVGBF 






[Two 1/0 areas, HOLD, COEDATA 


7336 1 


IJHAVGBS 






ITho I/O areas, HOLD, no 


CORDATA 


6822 ! 


IJHAVGCF 






[Two I/O areas, no HOLD, 


CORDATA 


6976 1 


IJHAVGCS 






[Two I/O areas, no HOLD, 


no COEDATA 


646 2 1 


IJHZXGZS 






[Load 




1556 j 


IJIBWEHH 


Direct 


Accesss 


[Undefined record 




2202 1 


IJIFHEHH 






[Fixed length 




1994 1 


IJISWBHH 






[Spanned record 




5110 \ 


IJIVWEHW j 






Variable length 




2140 } 


1JJCVA1K i 


Device 


Independent 


ASCII 




887 1 


IJJCVDV J 


(System) 


Il/O pointer 




751 1 


IJJCVDO 






[Fixed area I/O 




847 ! 


IJJFVBIC 


Device 


Independent 


[Output 




1029 1 


IJJFVIIC 


(User) 




[Input 




550 1 



i.--^-- ------ - — _ — — ___- — --_ -_.-.--_----—_«_- J 

Phases that are not used by the checkpointing program do not have to be pre-loaded into 
the SVA. 

:gxagples: 

1. If the program does not use ISA8, none of the nine ISAS phases needs to be 

pre-loaded. 

2. If ASCII=XES is not specified in the SOPVS macro at system generation time, IJJCVAIN 
need not be pre-loaded. 
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IPL and Buffer Load 



Link-Edit Statements 



IPL 



CORE IMAGE LIBRARY 

Transients 

I $$A$CDLO (optinal provided by the user) 
$$A$IPL1 
$$A$IPL2 

Phases 

$IPLRT2 
$IPLRT3 
$IPLRT4 
$IPLRT5 



RELOCATABLE LIBRARY 

Module 

IJBIPL 

Link-Edit St a tements 

INCLUDE IJBIPL 
// EXEC LNKEDT 

Buffer Load (1403U Printer) 

CORE IMAGE LIBRARY 

It is your responsibility to link-edit into 
the core image library the modules required 
for later use in LUCB and UCB job control 

statements, 

RELOCATABLE LIBRARY 

Modules 

IJBTRAN 
IJBTRGN 
IJBTRONA 
IJBTRPAN 

IJBTRPHN 

IJBTRPN 

IJBTRQNC 

IJBTRQN 

IJBTRRN 

IJBTRSN 

IJBTRTN 

IJBTRYN 

IJBTRALA 



PHASE phasename,+0 
INCLUDE IJBTRXXX 
// EXEC LNKEDT 

where xxx is a two or three character 
identifier of the train type on your 1403U. 



I Buffer Load (3203 Printer Model 1 and 2) 



CORE IMAGE LIBRARY 



Transients (Required for IPL) 

$$EFCB3 

$$BUCB3 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

Phase s 

SYSBUFLD 
SYSBUFFl 



RELOCATABLE LIBRARY 

Modules 

IJBSEUFF 

IJBSBUFl 

IJBTRAN 

IJBTRGN 

IJBTRONA 

IJBTRPAN 

IJBTRPHN 

IJBTRPN 

IJBTRQNC 

IJBTRQN 

IJBTRRN 

IJBTRSN 

IJBTRTN 

IJBTRYN 

IJBTRALA 

Link-E d it S tatements 

PHASE $$EUCB3,+0 
INCLUDE IJBTRXXX 
// EXEC LNKEDT 

where xxx is a two or three character 
identifier of the train type on your 3203 
printer other than the AN supplied in the 
core image library. 

PHASE SYSBUFLD, +0 
INCLUDE IJBSBUFF 
PHASE SYSBUFFl, +0 
INCLUDE IJBSBUFl 
// EXEC LNKEDT 
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Buffer Load (3203-4 Printer) 



Buffer Load (3211 Printer) 



CORE IMAGE LIBKAEY 



Transients (Eequired for IPL) 

$$BFCBOO 
$$BUCBO0 
$$BUFLDR 
$$BUFLD1 
$$BUFLD2 



C ORE IMAGE LIBRARY 

Transients (Required for IPL if 3211 is 

present) 

$$BFCB 

$$BUCB 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

RELOCATABLE LIBRARY 



Phases 

SYSBUFLD 
SYSBUFF1 

SELOCATABIjE LIBRARY 

Modules 

IJBSBUFF 

IJBSBUFI 

IJBTVAN 

IJBTVGN 

IJBTVOAA 

IJBTVOAB 

IJBTVODA 

IJBTVONA 

IJBTVPAN 

IJBTVPHN 

IJBTVPN 

IJBTVQNC 

IJBTVQN 

IJBTVEN 

IJBTVSN 

IJBTVTN 

IJBTVYN 

IJBTVALA 



Modules 

IJBSBUFF 
IJBSBUFI 
IJBTRAll 
IJBTRGll 
IJBTRHll 
IJBTRPll 
IJBTRTll 

Link-Edit Statements 

PHASE $$BUCB,+0 
INCLUDE IJBTRxnn 
// EXEC LNKEDT 

where xnn is the train on your 3211 printer 
other than the All supplied in the core 
image library (transient $$BUCB) . 

PHASE SYSBUFLD, +0 
INCLUDE IJBSBUFF 
PHASE SYSBUFFl,+0 
INCLUDE IJBSBUFI 
// EXEC LNKEDT 



Buffer Load (5203 Printer) 



Linj(c7, E< ^it Statements 

PHASJ3 $$BUCB0O, + 
INCLUDE IJBTVxxx 
// EXEC LNKEDT 

where xxx is a two or three character 
identifier of the train type on your 
3203-4 printer other than the AN supplied 
in the core image library. 

PHASE SYSBUFLD, +0 
INCLUDE IJBSBUFF 
PHASE SYSBUFFl,+0 
INCLUDE IJBSBUFI 
// EXEC LNKEDT 



CORE IMAGE LIBRARY 



Transients (Required for IPL) 

$$BFCB5 

$$BUCB5 (see Note) 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

Note; This transient is not required for 
IPL when the UCS feature is not present. 

Phase s 

SYSBUFLD 
SYSBUFFl 
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RELOCATABL E LIBRARY 

Modules 

IJBSBUFF 

IJBSBUFl 

IJBTRAN 

IJBTRGN 

IJBTRPN 

Link -Ed it S tatements 

PHASE $$BUCB5,+0 
INCLUDE IJBTRxx 
// EXEC LNKEDT 

where xx is the train type on your 5203U 
printer other than the AN supplied in the 
core image library- 

PHASE SYSBUFLD,+0 
INCLUDE IJBSBUFF 
PHASE SYSBUFFl,+0 
INCLUDE IJBSBUFl 
// EXEC LNKEDT 

3800 Printing Subsystem Support 

SETPRT (SET 3800 PRINTING SUBSYSTEM 
PARAMETERS ) 

CORE IMAGE LIBRARY 

Transients 

$$BUFLDR 
$$BUFLD1 
$$BUFLD2 

Phase (Required if 3800 is present) 

UVSPflDV 



RELOCATABLE LIBRARY 

Modules 

IJVSPRCM 
IJVSPRDV 
IJVSPRIO 
IJVSPR01 
IJVSPR02 
IJVSPR03 

Source Statement Library 

E.QSETPRT 
E. SETPRT 
E.SPLIST 

Link-Edit Statements 

For a list of the link-edit statements 
that are a part of the DOS/VS IBM 3800 
Printing Subsystem Independent Component 
Release (ICR) , see the link book in the 
"Program Directory" that comes with the 
ICR. 



lEBIMAGE (UTILITY FOR THE 3800) 

CORE IMAGE LIBRARY 

Phase 

lEBIMAGE 

RELOCATABLE LIBRARY 
Modules 

lEBIMAGE 
lEBIMSGS 
lEBIOBJT 
lEBISCAN 



GRFIxxxx (IBM-SUPPLIED GRAPHIC CHARACTER 
MODIFICATION PHASES) 

CORE IMAGE LIBRARY 

Phases 



GRF1 
GRF1 
GRF1 
GRFl 
GRF1 
GRFl 
GRFl 
GRFl 
GRFl 
GRFl 
GRFl 
GRFl 
GRFl 
GRFl 
GRFl 



IGSC 
IGSO 
IGS2 
IGS5 
IGUC 
IGUO 
IGU2 
IGU5 
lOSA 
lOSB 
ISP1 
ITS1 
ITS2 
ITUI 
ITU2 



RELOCATABLE LIBRARY 



Modules 



The module names of the GRFIxxxx modules 
are identical to the 1 5 phase names 
shown . 



XTBlxxxx (IBM-SUPPLIED CHARACTER 
ARRANGEMENT TABLEST" 

CORE IMAGE LIBRARY 

Phases 

XTBIAN 

XTBIAOA 

XTBIAOD 

XTB1A0N 

XTB1A11 

XTBIBOA 

XTB1B0N 

XTB1FM10 

XTB1FM12 
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XTB1FM15 

XTB1GFC 

XTB1GF10 

XTB1GF12 

XTB1GF15 

XTBIGN 

XTB1GSC 

XTB1GS10 

XTB1GS12 

XTB1GS15 

XTB1GUC 

XTBIGUIO 

XTB1GU12 

XTB1GU15 

XTB1G11 

XTB1HN 

XTB1H11 

XTB1KN1 

XTB10AA 

XTBIOAB 

XTBIODA 

XTB10NA 

XTB10NB 

XTBIPCAN 

XTB1PCHN 

XTB1PN 

XTB1P11 

XTB1QN 

XTBIQNC 

XTB1RN 

XTB1SN 

XTB1TN 

XTB1TU10 

XTB1T11 

XTB1XN 

XTB 1 YN 

XTB12773 

XTB12774 



RELOCATABLE LIBRARY 



$JOBCTLG 

$JOBCTLJ 

$JOBCTLK 

$JOBCTLM 

$JOBCTLN * 

$JOEEXIT 

$SYSOPEN ♦♦ 

♦ Required for Job Accounting Interface 
♦♦Only present in core image library. Not 
part of JCL proper. 

RELOCATABLE LIBRARY 

Modules 

$JOBACCT 

IJBJC 

IJBJCB 

IJBJCl 

IJBJC2 

IJBJC3 

IJBJCU 

IJBJC 5 

IJBJC6 

IJBJC7 

IJBJCB (Job Accounting Interface) 

IJBJC 9 

Link- Edit Statements 

INCLUDE IJBJC 
// EXEC LNKEDT 

INCLUDE $JOBACCT 
// EXEC LNKEDT 



Linkage Editor 



Modules 

The module names of the XTBlxxxx modules 
are identical to the 47 phase names shown. 



CORE IMAGE LIBRARY 



Phases 



$ LNKEDT 



Job Control 



RELOCATABLE LIBRARY 



CORE IMAGE LIBRARY 



Transients 



$$BJCOPT 
$$BJC0P1 
$$BLSTI0 



Modules 

IJBLEl 

Link-Edit Statements 

INCLUDE IJBLEl 
// EXEC LNKEDT 



Phases 

$JOBACCT 
$JOECTLA 
$JOECTLB 
$JOBCTLD 
$JCBCTLE 
$JOBCTLF 



WORK FILE REQUIREMENTS FOR LINKAGE EDITOR 

This section contains information for 
determining the work file requirements for 
the linkage editor and assembler when the 
work file is on as IBM DASD other than 
2311. 
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IJB«DS 
IJBMDU 
IJBMIN 
IJBBIO 
IJBMOP 
IJBSL2 

iinkzEdit statej en ts 

ISLCUDE IJBSL2 
// EXEC LNKEDT 

INCLODE IJBLBIO 
// EXEC LNKEDT 

INCLODE IJELBI1 
// EXEC LNKEDT 



CSERV 

Core laage Libraji 

Phage 

C3E8V 

Module 

IJBLBP 

Link-Edit Statggents 

INCLUDE IJBLBP 
// EXEC LNKEDT 

DSERV 

Phases 

DSEEV 

DSEFV1 

DSEEV2 

DSEBV3 

DSEEVft 

t)SEEV5 

DSEBV6 

Ei.l2S^table Library 

Modules 

IJBSL1 

Link-Edit Sta tements 

INCLODE IJESL1 
// EXEC LNKEDT 



PSERV 

Core la age Library 

Phase 

PSEBV 

Relocatable Library 

nodule 

IJBSL6 

LiJlKzMH statggents 

INCLODE IJBSL6 
// EXEC LNKEDT 

RSERV 

C2£® IlM.§ Library 

Plhase 

ESEBV 

Relocatable Library 

Modules 

TJBLBC 
IJBSL3 

LinKrEdit Statements 

INCLODE IJBSL3 
// EXEC LNKEDT 

SSERV 

Core Imaae Library 

Phase 

SSERV 

Relocatable Librar;^ 

Modules 

IJBLBC 
IJBSL4 

]^ink-Edit Statements 

INCLODE IJBSL4 
// EXEC LNKEDT 
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Supervisor Nucleus - 5745-SC-SUP 



CORE IMAGE LIBRAEY 



r 

1 Phase i 


Nuaber 


1 Number of 




I Name { 


of 


Library 


1 Benarks 


1 I 


Phases 


Blocks 




1 $$A$SUPO i 




a** 1 


Required for systea generation 64K Model 115 CPD 


1 $$A$S0P1 1 




aa 


Standard Supervisor 


1 $$A$SUP2 i 




I 52 




1 $$A$SUP3 1 




70 




i $$A$SUP4 1 




70 




1 $$A$S0P5 1 




82 




1 $$A$SUP6 1 




96 





120 D0S/7S Systea Generation 



CONFIGURftTIO N OF SUPERVISOR $$A$SUP1 

Figure 1-24 represents the parameters and their specification of the standard default 
supervisor for the 3330 resident system (generated devices can be adjusted at IPL-tims 
using ADD and DELETE commands) . 



MACRO 
GEN SUP VR 

$$A$SUP1 = POWER/VS SUPERVISOR, WITH RELLDR, VSIZE=512 

TITLE 'DOS/VS SUPERVISOR 1, SYSRES=333 0, MOD=125, NPARTS=2 ' 

SUPVR NPARTS=2 , POWER=YES , CHAN=YES , RNS=YES , PHO= YES , ID=1 

CONFG ^flODEL=125 

STDJC 

FOPT OLTEP=NO, SYSFIL=YES, RELLDR=YES, ECPREAL=YES , 

PFIX=YES 
PIOCS BMPX=YES,TAPE=7,DISK= (3330,3340,3350) 
VSTAB KSIZE=256K,VSIZE=512K,SVA=(6 4K,0K) 
ALLOC F1=152K 
ALLOCR F1R=16K 
lOTAB JIB=20,EGPGR=aO,FlPGR=10,D3U20=2, 02314=2, D 3 330=2, 

D3340=2,D3410=2,D3520=2,IODEV=20 
DVCGEN CHUN=X' GOD' DVCTYP= 2560 



DVCGEN CHUN=X'00E' 
DVCGEN CHUN=X*01F' 
DVCGEN CHUN=X'04C' 
DVCGEi>l CHUN=X'04D' 
DVCGTLN CHUN=X'160' 
DVCGEN CHUN=X'161* 
DVCGEN CHUN=X'162' 
DVCGEN CHUN=X'16 3» 
DVCGEN CHUN=X'28 0' 
DVCGEN CHUN=X'281' 
ASSGN SYSIOG,X'01F 
ASSGN SYSREC,X'160 
ASSGN SYSRDR,X'04C 
ASSGN SYSIPT,X'0 4C 
ASSGN SYSPCH, X'04D 
ASSGN SYSLST,X*00E 
ASSGN SYSLNK, X'161 
ASSGN SYS001,X'161 
ASSGN SYS002,X'161 
ASSGN SYS003,X'161 
ASSGN SYS004,X'161 



DVCTYP=3203 

DVCTYP=125D 

DVCTYP=3505 

DVCTYP=3525P 

DVCTYP=3340 

DVCTYP=3340 

DVCTYP=334 

DVCTYP=3340 

DVCTYP=3410T9 

DVCTYP=3410T9 



,BG 
,BG 
,BG 

,BG 
,BG 



DPD UNIT=X'160' ,VOLID=SYSRES,CYL=605 

SEND 



MEND 

GEN SUPVR 

END 

/ + 

/& 



Figure 1-24. Supervisor $$A$SUP1 — Supplied by IBM as Standard 
Default Supervisor for DOS/VS 
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HOW TO DISPLAY AND COMPILE SUPERVISOR S 

All source coding of the IBM-supplied supervisors is contained in the A.Sublibrary of the 
system source statement library under the names SUPO through SUP6, To obtain a printout, 
execute: 

// JOB SSERV 
// EXEC SSERV 

DSPLY A.SUP0,A,SUP1, ,A.SUP6 

/* 
/& 

To change the contents (in order to tailor a given supervisor) use the program MAINT. To 
compile the tailored supervisor, use: 

// JOB ASSEMBLE 
// OPTION DECK 
// EXEC ASSEMBLY 

COPY SUPx 

END 
/ + 
/g 

Supervisor Generation Macros (Basic) 

E. ALLOC 

E.ALLOCR 

E.ASSGN 

E . BDYBOX 

E.CONFG 

E.DISP 

E.DPD 

E . DVCGEN 

E.FOPT 

E.IOINTER 

E.IOTAB 

E.ISTAVT 

E . MAPCOMR 

E.MAPERPIB 

E, MORAS 

E.MAPLOWC 

E,MAPPUB2 

E.PIOCS 

E.SEND 

E . SGAM 

E.SGCCWT 

E.SGDFCH 

E.SGDSK 

E.SGEND 

E.SGPMAIN 

E.SGPOPT 

E.SGPSUB 

E.SGSCVRT 

E.SGSVC 

E.SGSVCX 

E.SMICR 

E.STDJC 

E . SUPVR 

E-SYSIO 

E.VSTAB 

For a detailed description of storage requireirents, refer to "Supervisor Storage 
Requirements". 
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Teleprocessing 

E.IJLQDSCT 
E.IJLQTSVC 

Note ; These macros are part of the QTAM program but are required to generate a QTAM 
supervisor. 

Display Operator Conso le Sup port 

E.CRTGEN 
E.CRTSAV 

Note ; These macros are required to generate a supervisor with Display Operator Console 
support. 

POWER/VS 



Macros 

E.IPW$DPA 
E.IPW$DPD 
£-IPW$DDE 

These macros are part of the POHEE/VS pcogzraa. They are required to generate a supervisor 
with support of POKEfi/?S (POSEB^YES specified in the SOPVB «acro instruction) . 

MCAR/CCH (RMS) 



CORE IMAGE LIBRARY 



Transients 

$$ABERA1' 

$$ABERA2 

$$ABERA3 

$$ABERAy 

$$ABERA5 

$$ABERA6 

$$ABERA7 

$$ABERRJ 

$$ABERRP 

$$AEERRQ 

$$BCCHHR 

$$RASTOO 

$$RAST01 

$$RAST02 

$$RAST03 

$$RASTOU 

$$RAST05 

$$RAST06 

$$RASTOS 

$$RAST09 

$$RAST10 

$$RAST11 

$$RAST13 



RMSR 



Statistical counter update (non-tape) 

3211 RMSR 

3211 RMSR 

t scans Cl-directory for all $$RASTnn phases 

CCH and Initial MCAR analysis 

Channel and machine check record builder and recorder 

Channel check analysis 

EFL and MCAR analysis 

Unit record channel check ERP 

Unit record channel check ERP 

3505 and 3525 channel check handler ERP 

Machine check and channel check record writer 

Partition reallocation 

ERP message viriter 

Message writer 

Partition reallocation 
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252ICE EBBOB ROyTIMBS ^WD pPgW^C^OSli PHJgfS fO» fiOg/JS 

The following is a list of required system control and coiripon IOCS transients. Type A 
transient routines (device error routines) have the prefix $$A. ($ is an alphabetic 
character in Systein/370.) Type B transient routines (OFEN« CLOSE. CHKPT, and so on) have 
the prefix $$B. 

$$A$SUP1 Supervisor 

$$AB£RAA Statistical counter update (tape) 

$$ABERAB Tape ERP 

$$ABERAC Tape ERP 

$$AEERAD Tape ERP 

$$ABERAE Tape ERP 

$$ABERAF Tape ERP 

$$ABERAG Tape ERP 

$$ABERAH Tape ERP 

$$ABERAI Tape ERP 

$$AEERAN 3886 OCR ERP 

$$lBSfiAO 3895 ERP Phase 1 

$$AB£BAP 3895 EBP Phase 2 

$SABEBAQ 3895 OBB record baildar 

SIABEBAB 3895 HDB record builder 

$$ABERA1-$$ABERA7 RMSR 

$$ABERBA 3800 error recovery 

$$ABERBC 3800 MOR record writer 

$$ABERBD 3800 OBR record writer 

$$ABERP1-$$ABERP9 BTAM ERP 

$$ABERRA Error recovery monitor 

$$ABERRB Disk ERP 

$$ABERRC Setup 2560 restart information 

$$ABERRD 2560/ 5U25 ERP repositioning 

$$ABERR£ Setup 512 5 restart information 

$$ABERRF PRTl ERP 

$$AB£RRG 3504/3505 Card reader and 3525 card punch ERP 

$$ABERRH 22 U 5 ERP (Kanji printer support) 

$$ABERRI 2195 tape cartridge reader ERP 

$$ABERRJ Statistical counter update (non-tape) 

$$ABERRK RMSR message writer 

$$ABERRL ERP message writer 

$$ABERRM ERP message writer 

$$ABERRN ERP message writer 

$$ABERRO ERP message writer 

$$ABERRP PRTl RMSR 

$$ABERRQ PRTl RMSR 

$$ABERRR 2560 ERP 

$$ABERRS MICR ERP 

$$ABERRT 1287/1288 OCR ERP 

$$ABERRU 1017/1018 Paper tape ERP 

$$ABERRV 2671 Paper tape ERP 

$$ABERRW 1052 Console printer keyboard EBP 

$$ABERRX Unit record error recovery 

$$ABERRY Unit record ERP 

$$ABERRZ Physical attention routine 

$$ABERR1 2311 Data cell ERP 

$$ABERR2 2321 Data cell ERP 

$$ABERR3 2321 Data cell ERP 

$$ABERR1 2321 Data cell ERP 

$$ABERR5 2321 Data cell ERP 

$$AEERR7 3540 Diskette ERP 

$$ABERZ1 Physical attention routine 

$$ABERZ2 Physical attention routine 

$$BATTF0 FCB load initiation (macro invoked) 

$$BATTF1 LFCB Command processor 2 

$$BATTF2 LFCB Macro execution CPRTl) 

$$BATTF3 LFCB Macro execution (non-PRTi printers with PCB, excluding the 3800) 

$$BATTFU FCB Load execution (non-PRTl printers with FCB, excluding the 3800) 

$$BATTF5 FCB Load execution (PRTl) 
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$$BATTNA 
$$BATTNB 
$$BATTNC 
$$BATTND 
$$BATTNE 
$$BATTNF 
$$BATTNG 
$$BATTNH 
$$BATTNQ 
$$BATTNR 
$$BATTNS 
$$BATTNT 
$$BATTNU 
$$BATTNV 
$$BATTNW 
$$BATTNX 
$$BATTNY 
$$BATTNZ 
$$BATTN2 
$$BATTN3 
$$BATTN5 
$$BATTN8 
$$BATTN9 
$$BATTU1 
$$BATTU2 
$$BCCPT1 
$$BCE0V1 
$$BCHKPD 
$$BCHKPE 
$$BCHKPF 

I $$BCHKPG 
$$BCHKPT 
$$BCHKP2 

I $$BCHKP3 
$$BCHK3G 
$$BCISOA 
$$BCLOSE 
$$BCLOSP 
$$BCL0S2 
$$BCL0S3 
$$BCLOSa 
$$BCLRPS 
$$BCMT01 
$$BCMT02 
$$BCMT03 
$$BCMTO'* 
$$BCMT05 
$$BCMT06 
$$BCMT07 
$$BCMT08 
$$BDMPBC 
$$BDMPDC 
$$BDMPPD 
$$BDMPPT 
$$BDMPVA 
$$BDUMP 
$$BDUMPB 

$$BDUMPD 

$$BENDFF 

$$BENDFI, 

£$BENDQB 

^^BEOJ 

$$BEOJl 

$$BEOJ2 

$$BE0J2A 

$$BE0J3 

$$BE0J3A 

$$B£Oja 

$$B£0J5 



Supervisor, 
Supervisor, 



Supervisor, 
Supervisor, 
Supervisor, 
Supervisor, 



program teririnator 

program terminator 
Supervisor, initiator 
Supervisor, nonresident attention routine 
Supervisor, nonresident attention routine 
Supervisor, nonresident attention routine 
Supervisor, nonresident attention routine 

nonresident attention routine 

nonresident attention routine 

nonresident attention routine 

nonresident attention routine 
Process ALTER statement 
Process DSPLY statement 
DUMP coirirand processor 
DUMP command processor 
DUMP command print routine 
Supervisor, nonresident attention routine 
Supervisor, nonresident attention routine 
Display and change dispatching priority 
SDAIC termination routine 

Storage dump of part of storage specified by two addresses 
LFCB Command processor 1 
LUCB Command processor 1 
LUCB Command processor 2 
UCB Load execution 
System, required tape open 
Monitor-EOV/EOF 
Disk- checkpoint 
Disk-checkpoint 
Disk- checkpoint 

Disk-checkpoint, 3800 record processing 
Tape-checkpoint 
Tape- checkpoint 

Tape-checkpoint, 3800 record processing 
Erase gap for logical files 
ISAM - CLOSE 
Close monitor 
Punch file close 
Close 

Close monitor 
Close monitor 
Close RPS 

Tape EOF/EOV input-forward 
Tape CLOSE-alternate switching 
Tape CLOSE input-backward 
Tape EOV output- forward 
Tape CLOSE 

Tape CLOSE - work files 
Tape-alternate switching 
Tape CLOSE - without work files 

Supervisor, program termination and system dump on tape/printer (part 2) 
Supervisor, program terminator, and system dump on disk (part 2) 
Format supervisor block, disk output 
Format supervisor block, tape/printer output 
Supervisor, program terminator, and SVA dunip 
Supervisor, program terminator^ and system dump monitor 
Supervisor, program terminator, and system dump on tape/printer 
(part 1> 

Supervisor, program terminator, and system dump on disk (part 1) 
ISAM - ENDFL (Load phase 2) 
ISAM - ENDFL (Load phase 1) 

Blocks B-transient area for ENQB/DEQB function 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program teririnator 
Supervisor, program terminator 
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$$BEOJ7 

$$BERRTN 

$$BFCB 

$$BFC660 

$$BFCB3 

$$BFCB5 

$$EILSVC 

$$BINDEX 

$$BJCOPT 

$$BJC0P1 

$$BJDUMP 

$$BLVTOC 

$$BLSTIO 

$$BMSGWR 

$$BMSGW1 

$$BMVKEY 

$$B0CPM1 

$$B0CPM2 

$$BOCPRP 

$$B0CPT1 

$$B0CPT2 

$$B0CPT3 

$$BOCPTM 

$$BOCP01 

$$BOCP02 

$$EOCP0 3 

$$B0CP11 

$$B0CP12 

$$BOCRTA 

$$BOCRTB 

$$BOCRTC 

$$BOCRTD 

$$BOCRTE 

$$BOCRTF 

$$BOCRTG 

$$BOCRTH 

$$BOCRTK 

$$BOCRTL 

$$BOCRTM 

$$BOCRTN 

$$BOCRTO 

$$BOCRTP 

$$BOCRTQ 

$$BOCRTR 

$$BOCRTS 

$$BOCRTT 

$$BOCRTU 

$$BOCRTV 

$$BOCRTW 

$$BOCRTX 

$$BOCRTY 

$$BOCRTZ 

$$BOCRTl 

$$B0CRT2 

$$BOCRT3 

$$BOCRT'» 

$$B0CRT5 

$$B0CRT6 



Supervisor, prograir- teririnator 

System required error recovery 

3211 FCB standard load 

3203-i» FCB standard load 

3203 FCB standard load 

5203 FCB standard load 

Supervisor « program teririnator 

Cylinder index in core (ISAM) 

Job Control, OPEN Tape routine 

Job Control, OPEN Tape routine 

JDUMP indicator 

List VTOC (2311, 2314/19^, 3330, and 3340) 

System control 

Tape open/close 

Tape open/close 

Printlog utility status modifier 

System required message writer 

System required message writer 

System required OPEN for RPS DASD 

System required OPEN for input tape (Phase 1> 

System required OPEN for unlabeled output tape 

System required OPEN for labeled cutput tape 

System required OPEN for input tape (Phase 2) 

System required table, disk DTFs, OPEN Version II 

System required table^ nondisk DTFs, OPEN Version II 

System required table, unit record, OPEN Version II 

System required table, tape or disk system DTFs, OPEN Version I 

System required table, tape system DTFs 

CRT task initialization, activation, and deactivation 

Hard- copy disk ERP 

Message analysis and message transfer to screen buffer 

Multiline message transfer to screen buffer 

CRT ERP, part 1 

CRT ERP, part 2 

Redefine message status; output from buffer to screen 

Message writer screen to hard-copy file 

CRT task activator and operator input check routine 

Message deletion by means of K command 

Message deletion by means of cursor 

K-comroand handler status definition 

Screen line-number handler 

Restore function for release 

Screen update 

Initialize read 

Read/comma nd 

Move data 

Updating of wraparound pointer in hard-copy file 

Cursor positioning in case of error 

Message writer 

conversation handler 

Multiline message handler 

CRT root phase 

Redisplay - supervisor interface 

Redisplay - command analysis 

Redisplay - read messages from hard-copy file 

Redisplay - write to screen 

Redisplay - save/restore screen image 

Redisplay - cominand checking 



Note: The DOC-support transients ($$BOCRTn) are automatically 
generated if MODEL=115 or 125 is specified in the CONFG macro. If DOC 
support is not desired, a DELET statement is required for each trans- 
ient. If DOC support is required but one or more of the DOC-support 
transients have been deleted, the systeir enters a hard wait state. 



$$BODACL 
SifiODAIM 
$$BODAIN 
$$B0DAI1 



Close Routine- DA 
Overlay phase for ODAIN 
Direct access input-OPEN (Input) 
Open input-DA 
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$$B0DA01 Direct access-OPEN output Phase 1 

$$B0DAO2 Direct access-OPEN output Phase 2 

$$B0DA03 Direct access OPEN-output Phase 3 

$$B0DA04 Direct access OPEN-output Phase H 

$$BODARP Direct access-OPEN PPS Phase 1 

$$BODARS Direct access-OPEN EPS Phase 2 

$$B0DAU1 Direct access-OPEN 

$$B0DI01 Diskette OPEN-input Phase 1 

$$B0DI02 Diskette OPEN-output Phase 3 

$$B0DI03 Diskette OPEN-output Phase «» 

$$BODIoa Diskette CLCSE-input/output 

$$B0DIO5 Diskette OPEN-input Phase 3 

$$B0DI06 Diskette OPEN-input Phase U 

$$B0DI07 Diskette OPEN-output Phase 5 

$$B0DI08 Diskette OPEN-output Phase 6 

$$BODMSG Diskette Message Writer Phase 1 

$$B0DMS2 Diskette Message Writer Phase 2 

$$BODQUE Dequeue JIBs 

$$BODSMO Diskette security message writer 

$$BODSMW Message writer 

$$BODSPQ Diskette VTOC Display Phase 2 

$$BODSPV Disk VTOC display routine 

$$BODSPW Disk VTOC display routine 

$$BODUCP Diskette DTFCP/DTFDI OPEN 

$$BOFLPT DASD file protect 

$$BOISRP ISAM - OPEN RPS phase 

$$BOIS01 ISAM - OPEN I/O Phase 1 

$$BOIS02 ISAM - OPEN I/O Phase 2 

$$BOIS03 ISAM - OPEN I/O Phase 3 

$$BOIS04 ISAM - OPEN I/O Phase U 

$$BOIS05 ISAM - OPEN I/O Phase 5 

$$BOIS06 ISAM - OPEN I/O Phase 6 

$$BOIS07 ISAM - OPEN I/O Phase 7 

$$BOIS08 ISAM - OPEN I/O Phase 8 

$$BOIS09 Indexed sequential independent overflow area integrity 

$$BOIS10 ISFMS - OPEN 

$$B0IS11 ISAM - OPEN 

$$BOMRCE OPEN for OMR and RCE 

$$B0MSG1 Message writer - non-abort types 

$$B0MSG2 Message writer - abort types 

$$BOMSG3-$$BOMSG8 Message writer 

$$BOMT0M Tape OPEN message 

$$BOMT0W Tape OPEN message 

$$BOMT01 Tape OPEN input-forward- Standard labels (Phase 1) 

$$BOMT02 Tape OPEN input-baclcward-standard labels 

$$BOMT03 Tape Open output forward- standard label 

$$BOMT04 Tape OPEN Output-Standard labels 

$$BOMT05 Tape OPEN I/O-f orward/backward nonstandard/unlabeled 

$$BOMT06 Tape OPEN work files 

$$BOMT07 Tape OPEN input-forward-standard labels (Phase 2) 

$$BONVOL Tape rewriting 

$$BOPEN RMSR tape processor 

$$BOPENC OPENC 

$$BOPEND Disk OPEN volume ID handler 

$$BOPENR Relocation Phase 1 

$$BOPENS Common RPS OPEN initialization routine 

$$BOPEN0 33 UO DTF device type update phase 

$$B0PEN1 Open monitor 

$$B0PEN2 Open monitor 

$$B0PEN3 Open monitor 

$$BOPENU Open monitor 

$$BOPIGN Open monitor 

$$BOPNLB Locates system source statement library (for assembler, COBOL, MAINT, 

and SSERV) or procedure library (for PSERV) 

$$B0PNR2 Relocation Phase 2 

$$B0PNR3 Relocation Phase 3 

I $$B0PR3 Open processing for 3800 printer 

$$BORTVl ISAM Open 

s4bORTV2 ISAM Open 

9$B0SDB1 Support for DI.BL blockslze 
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$$B0SDC1 

$$B0SDC2 

$$B0SDC3 

$$BOSDEV 

$$B0SDI1 

$$B0SDI2 

$$B0SDI3 

$$B0SDI4 

$$B0SDI5 

$$B0SD01 

$$BOSD02 

$$B0SDO3 

$$BOSDOU 

$$B0SD05 

$$B0SD06 

$$B0SD07 

$$B0SD08 

$$B0SDO9 

$$BOSDRP 

$$BOSDRR 

$$BOSDRS 

$$B0SDW1 

$$B0SDW2 

$$B0SDW3 

$$BOSD00 

$$BOSD01 

$$BOSD02 

$$BOSD03 

$$BOSIGN 

$$BOUR01 

$$BOVDMP 

$$BOWDMP 

$$B02321 

$$BPCHK 

$$BPCLOS 

$$BPDAID 

$$BPDUMP 

$$BPDMPC 

$$BPSW 

$$BRELSE 

$$BRMSG1 

$$BRMSG2 

$$BRSTRB 

$$BRSTRT 

$$BRSTR2 

$$BRSTR3 

$$BRSTRU 

$$BSDRUP 

$$BSETFF 

$$BSETFG 

$$BSETFH 

$$BSETFI 

$$BSETFL 

$$BSETL 

$$BSETL1 

$$BSETL2 

$$BSYSWR 

$$BTERM 

$$BUCB 

SSBUCBOO 

$$BUCB3 

$$BUCB5 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

$$BVSDMP 

$$B3540I 

$$B35U0O 

$$B35U00 

$$BPDZAP 

$$VOPENT 



Sequential disk I/O - CLOSE 

Sequential disk-close 

Sequential disk-close Part 2 

DTFDA and DTFSD Forced End of Voliane 

Sequential disk input - OPEN 

Sequential disk input - OPEN 

Sequential disk input - OPEN 

sequential disk input - OPEN 

Sequential disk OPEN - update phase 

Sequential disk output Phase 1 - OPEN 

Sequential disk output Phase 2 - OPEN 

Sequential disk output Phase 3 - OPEN 

Sequential disk output Phase *i - OPEN 

Sequential disk output Phase 5 - OPEN 

Sequential disk open - Phase 6 

Sequential disk output - OPEN 

Sequential disk output - OPEN 

Sequential disk output - OPEN 

Sequential disk OPEN-RPS Phase 1 

Sequential disk OPEN-RPS Phase 2 

Sequential disk OPEN-RPS Phase 3 

Sequential disk work files Phase 1 - OPEN 

Sequential disk work files Phase 2 - OPEN 

Sequential work file Phase 3 - OPEN 

Sequential disk OPEN - output Phase 

Sequential disk OPEN - output Phase 1 

Sequential disk OPEN - DLBL extents for 33 UO 

Sequential disk OPEN - Output Phase 1 

System open 

Unit record-OPEN routine 

Disk VTOC dump 

Disk VTOC dump 

OPEN data cell 

Supervisor - program terminator 

Automatic Close for 3800 printer 

Problem Determination 

PDUMP on SYSLST (part 1) 

PDUMP on SYSLST (part 2) 

Supervisor - program terminator 

Device release 

Message writer CHKPT-RSTRT 

CHECKPOINT-RESTART message writer 

Tape Restart 

RESTART message writer - Phase 2 

Tape and DASD verify for restart 

DASD verify for restart 

Tape Reposition 

Suppress writing on recorder file 

ISAM load Phase 2 of SETFL 

ISAM load Phase 3 of SETFL 

ISAM load Phase «♦ of SETFL 

ISAM Phase of SETFL 

ISAM load Phase 1 of SETFL 

ISMOD - SETL 

ISMOD - SETL 

ISMOD - SETL 

Supervisor* nonresident attention 

Supervisor, program terminator 

3211 UCSB standard load 

3203-4 ncsB standard load 

3203 UCSB standard load 

5203 UCSB standard load 

3203, PRT1, 5203, and 3800 FCB and UCSB IPL loader 

3203, PRT1, 5203, and 3800 FCB IPL loader 

FCB and UCSB IPL loader error routine 

Highspeed dump 

Diskette OPEN- input Phase 1 

Diskette OPEN- output Phase 1 

Diskette OPEN- Phase 

I/O for PDZAP 

common RPS OPEN SVA loading routine 
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Attention Routines, Initiators, Terminators, 
and Dumps (AIT) 



RELOCATABLE LIBRARY 



Modules 



Standard System Dump 



C ORE IiyJAGE LIBRARY 

Transients 

$$BDMPBC 

$$BDMPDC 

$$EDMPPD 

$$BDMPPT 

$$BDiyiPVA 

$$BDUMP 

$$BDUMPB 

$$BDU]yiPD 

$$BJDUMP 

$$BPDMPC 

$$BPDUMP 



R ELOCATABLE LIBRARY 
Modules 

IJBDMB ♦ 
IJBD^5BST 
IJBDMD * 
IJBDMDST 
IJBDMPMO * 
IJBDMPPD * 
IJBDMPPT * 
IJBDMPVA + 
IJBDUMPS 
IJBJDMP * 
IJBPDPMO * 
IJBPDPST 

♦ Modules coitirron to Standard Systeiti Dump and 
Translating System Dump. 

Link-Edit Statements 

INCLUDE IJEDUMPS 
// EXEC LNKEDT 



Translating System Dump 



CORE IMAGE LIERARY 

Transients 

$$BDMPBC 
$$BDMPDC 
$$BDMPPD 
$$BDMPPT 
$$BDMPVA 
$$BDUMP 
$$BDUiyiPB 
$$EDUiyiPD 
$$BJDUMP 
$$EPDMPC 
I $$BPDUMP 



IJBDMB * 
IJBEMBTR 
IJBDMD * 
IJBDMDTR 
IJBDMPMO * 
IJBDMPPD * 
IJBDMPPT + 
IJBDMPVA * 
IJBDUMPT 
IJBJDMP + 
IJBPDPMO + 
IJBPDPTR 

♦Modules common to Standard System Dump and 
Translating System Dump, 

Link-Edit St atements 

INCLUDE IJBDUMPT 
// EXEC LNKEDT 



Attention Routines, Initiators, 
Terminators 

CORE IMAGE LIBRARY 

Transi ents 

$$AEERRZ 

$$ABERZ1 

$$AEERZ2 

$$BATTNA 

$$EATTNE 

$$BATTNC 

$$BATTND 

$$BATTNE 

$$BATTNF 

$$BATTNG 

$$BATTNH 

$$BATTNQ 

$$BATTNR 

$$BATTNS 

$$BATTNY 

$$BATTNZ 

$$BATTN2 

$$BATTN3 

$$BEOJ 

$$BEOJSl 

$$BEOJS2 

$$BEOJl 

$$BE0J2 

$$BE0J2A 

$$BEOJ3 

$$BE0J3A 

$$BEOJU 

$$BE0J5 

$$BE0J7 

$$BILSVC 

$$EPCHK 

$$BPSW 

$$BSYSWR 

$$BTERM 
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Checkpoint/Restart 



CORE IMAGE LIBRARY 

Transients 

$$ECHKPD 
$$BCHKPE 
$$BCHKPF 
$$BCHKPT 
$$BCHKP2 
$$BCHK3G 
$$BRMSG1 
$$BRMSG2 
$$BRSTRT 
$$BRSTR2 
$^BRSTR3 
$$BRSTRf| 



SOURCE STATEMENT LIBRARY 



Macro 



$$BOCRTH 
$$BOCRTK 
$$EOCRTL 
$$BOCRTM 
$$BOCRTN 
$$EOCRTO 
$$BOCRTP 
$$EOCRTQ 
$$BOCRTR 
$$EOCRTS 
$$BOCRTT 
$$EOCRTU 
$$BOCRTV 
$$EOCRTW 
$$BOCRTX 
$$BOCRTY 
$$BOCRTZ 
$$B0CRT1 
$$B0CRT2 
$$B0CRT3 
$$BOCRTU 
$$B0CRT5 
$$B0CRT6 



CHKPT 

If RPS is supported see section "RPS 
Considerations" . 



Disk Error Recovery Procedures (DKE) 



CORE IMAGE LIBRARY 



SOURCE S TA T EMENT LIBRARY 
Macros 

CRTAEX 

CRTAWT 

CRTGEN 

CRTIO 

CRTSAV 

PUTR 



Transients 

$$ABERRB 
$$ABERR1 
$$ABERR2 
$$AEERR3 
$$ABERR4 
$$ABERR5 



SOURCE STATEMENT LIBRARY 



Macro 



SGDSK 



Display Operator Console Support (DOC) 



CORE IMAGE LIBRARY 

Transients 

$$BMVKEY 
$$BOCRTA 
$iBOCRTB 
$$BOCRTC 
$$BOCRTD 
$$BOCRTE 
$$BOCRTF 
$$BOCRTG 



PRINTLOG (Print the Hard-Copy 
FUe) 

CORE IMAGE LIBRARY 













r 

1 Phases 
1 Blocks 






1 
1 


1 

5 


L 










Phase 










PRINTLOG 










RELOCATABLE 


LIBRARY 






r 

[Modules 
1 Blocks 






I 
1 


1 
20 


L 






J. 




Module 










IJBPRT 










Link-Edit 


Statements 







INCLUDE IJBPRT 
// EXEC LNKEDT 
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Tape Error Recovery Procedures (TPE) 



CORE IMAGE LIBRARY 



Transients 



$$ABERAB 
$$ABERAC 
$$ABERAD 
$$AEERAE 
$$ABERAF 
$$AEERAG 
$$ABERAH 
$$ABERAI 
$$RAST07 
$$RAST12 

Phase 

ESTVUT 



RELOCATABLE LIBRARY 

Module 

IJBTESUT 

Link-E dit St atements 

INCLUDE IJBTESUT 
// EXEC LNKEDT 



$$BATTNV 
$$BATTNWi 
$$BATTNX 
$$BPDAID 



REL OCATABLE LIBRARY 

Modules 

IJBPDAID 
IJBPELST 

Link-Ed it S tatements 

// JOB 

// OPTION CATAL 

INCLUDE IJBPDAID 

// EXEC LNKEDT 

INCLUDE IJBPDLST 

// EXEC LNKEDT 

/& 



DUMPGEN 



CORE IMAGE LIBRARY 



Phase 



DUMPGEN 



Problem Determination Aids (PDA) 



RELOCATABLE LIBRARY 



PDAID 

CORE IMAGE LIBRARY 

Phases 

PDAIDFTT* 
PDAIDFTP+ 
PDAIDFTW* 
PDAIDGTT+ 
PDAIDGTP* 
PDAIDGTW+ 
PDAIDITT* 
PDAIDITP* 
PDAIDITW* 
PDAIDQTT* 
PDAIDQTW* 
PDAIDTDP* 
PDAIDTDT* 
PDAIDVTT* 
PDAIDVTW+ 

♦Only present in core-image library. 

Transients 

$$BATTNT 
$$BATTNU 



Module 



IJBEMPGN 



Lin k-Edit St atements 

INCLUDE IJBDMPGN 
/ + 
// EXEC LNKEDT 



SDAID 



CORE IMAGE LIBRARY 



Pha ses 

SDAID 
SDAID 2 
SDPAR 
ENDSD 



Transi ents 

$$BSDAID 
$$BATTN5 
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RELOCATABLE LIBRARY 



Link-Edit Statements 



Modules 



IJESDADl 
IJBSDAD2 
IJBSDEND 
IJBSDPAR 



Link-Edit Statements 



// JOB 

// OPTION CATAL 

INCLUDE IJESDLNK 
/ + 
// EXEC LNKEDT 



// JOB 

// OPTION CATAL 

INCLUDE IJBPDZAP 
/* 
// EXEC LNKEDT 



Highspeed Standalone Dump 

CORE IMAGE LIBRARY 

Pha se 

DOSVSDMP 

Transient 

$$BVSDMP 



LSERV 

CORE IMAGE LIBRARY 

Phase 

LSERV 

RELOCATABLE LIBRARY 

Module 

IJBLSERV 

Link-Edit Statements 

INCLUDE IJBLSERV 
/ + 
// EXEC LNKEDT 

CBL Patch Program (PDZAP) 



RELOCATABLE LIBRARY 

Modules 

IJBDMPER 
IJBDMPHS 
IJBDMPMS 

Link-Edit St atements 

// JOB 

// OPTION CATAL 

INCLUDE IJBDMPHS 
// EXEC LNKEDT 
/& 

Page Data Set Dump 

CORE IMAGE LIBRARY 

Phase 

PESEM 



CORE IMAGE LIBRARY 

Phas e 

PDZAP 

Transient 

$$BPDZAP 

RELOCATABLE LIBR ARY 
Module 



IJBPDZAP 



RELOCA TABLE LIBRARY 

Module 

IJEPDSDM 

Link-E d it Statements 

INCLUDE IJEPDSDM 
/* 

// LELTYP TAPE (see Note) 
// EXEC LNKEDT 

Note : Required only if tape is to be used 
for interirediate storage of the page data 
set dump. 
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Module 2: POWER/ VS - 5745-SC-PWR 



I The information previously provided in this module of the manual has been removed and is 
I nov contained in DOS/VS PQKER/VS Installation Guide and Eeference, GC33-6048. 
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Module 3: Installation Verification Procedure 



Module Outline 

introduction 137 

the standard SCP functions 137 

the optional SCP functions 137 

IVP books 137 

IVPGEN-stage I — assembly 137 

IVPGEN-stage II — execution 138 

preparing the IVP job stream 142 

setup requirements 1 42 

operating instructions 142 

ABD - the ABEND dump 143 

ASL 143 

example of SYSLOG output 143 

example of SYSLST output 143 

CAP - cataloged procedures 147 

setup requirements 147 

example of SYSLOG output 147 

example of SYSLST output 148 

EMA - 1401/1440/1460 emulator 157 

functions tested 157 

IVPGEN macro options 157 

required parameters 157 

optional parameters 157 

software requirements 158 

emulator macro options 158 

hardware requirements 159 

storage requirements 159 

operating instructions 159 

EMB - 1410/7010 emulator 159 

functions tested 159 

IVPGEN macro options 159 

required parameter 159 

optional parameters 1 59 

software requirements 160 

hardware requirements 1 60 

storage requirements 161 

operating instructions 161 

E20 - System/360 model 20 emulator 

functions tested 161 

IVPGEN macro options 161 

required parameter 161 

hardware requirements 1b2 

operating instructions 1 62 

example of SYSLOG output 163 

example of SYSLST output 164 

OLT - OLTEP 165 

function tested 165 

operating instructions 165 

action messages 165 

PWR - POWER/VS U 5 

function tested 165 

software requirements 165 

UTL - system utilities 165 

functions tested 165 

hardware requirements 166 
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Module Isidex 



ABD 138, 143 

ABEND dump, the 138,143 

ASL 138,143 

assembler (ESERV) 

example of SYSLOG output 143 

example of SYSLST output 143-146 



CAP- , . , . 138,147 

cataloged procedures (CAP) , 147 

example of SYSLOG output 147 

example of SYSLST output 148- 15b 



LMA 138,157 

emulators 

14 01/14 4 0/14 6 (EMA) 157 

1410/7010 (EM3) 159 

SYStein/360 rtiodel 20 (E20> 161 

example of SYSLOG output 163 

example of SYSLST output 164 

EMB. ....... 138^159 

E20. 138,1 61 

ESERV program (ASL) 143 

example of JCL statements 141 



IVP books 1 

IVPGEN 

stage I - assembly 1 

stage II - execution 1 

macro options. 1 

IVPGEN parameters, component 
dependent 

ABD 1 

ASL ,. 1 

CAP ...... 1 

EMA. 138,1 

EMANAME . 1 

EMATA. . 1 

EMATSN 1 

EMATYPE, . , 1 

EMB ,. 138,1 

EMBNAME 1 
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EMBTA 138 

EMBTSN 138 

E2 138, 161 

E2 0NAME 138 

OLT 1 ., H 

PWR 139 

UTL 13 9 

UTLDA 139 

UTLDRT 139 

UTLDT 1 J 9 

UTLDV 139 

UTLT. 139 

UTLTA , - 139 

UTLTM 13 9 

UTLZ 139 

UTLZA 139 

UTLZCN 139 

UTLZRT 139 

IVPGEN parameters, component 
independent 

DELUNSD 14 

DELUSED 140 

IPTADDR 140 

LSTADDR . 14 

PCHADDR 140 

RERUN 140 

VERIFY - 140 

OLT 138, 165 

OLTEP (OLT) 165 

operating instructions 142 

optional SCP functions 137 

PWR 139, 165 

POWER/VS (PWR) •. 165 

setup requirements 142 

standard SCP functions 137 

system utilities (UTL) 165 

UTL , 139, 165 
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Introduction 



DOS/VS provides Installation Verification Procedures to enable you to verify the 
generation of system components. IVP verifies components such as the eirulators, which 
are user-assembled, and systeiti utilities. 

The IVP consists of a set of macros (containing the verification procedures) which are 
distributed, along with tne DOS/VS system, on the IBM-supplied distribution medium. 
Towards the end of system generation, after having deleted any unwanted DOS/VS system 
components and having generated the components you require for verification, you should 
perform the installation verification procedure. 

The verification procedures are generated by assembling the IVPGEN macro. A number of 
parameters specify the optional SCP functions selected for verification, in addition to 
the standard functions which are included automatically. The standard functions are not 
included if you are running the program again to verify one or more functions only 
(indicated by the parameter RERUN=YES in the IVPGEN miacro) . For a complete description 
of the parameters of the IVPGEN macro refer to the section entitled "IVPGEN Parameters". 

The Standard SCP Functions 

ABD - The ABEND Dump (part of program 57 4 5-SC-AIT) 

ASL - The assembler librarian Edit/De-Edit routines (part of the assembler program 

5745-SC-ASiyi) 
UTL - The system utilities Disk-Only functions. Card, tape, and data cell functions are 

configuration dependent and optional (part of program 574 5-SC-UTL). 

The Optional SCP Func tions 

CAP - Cataloged procedures 

EMA - System/370 Emulator for IBM 140 1/14U0/1460) Available only as 

EMB - System/370 Emulator for IBM 1410/7010 f independent release 

E20 - System/360 Model 20 Emulator 

OLT - OLTEP 

PWR -• POWER/VS 

IVP Books 

The separate parts that make up each verification procedure are contained in one or more 
pre-edited source statement library macro books. 

IVPGEN-Staqe I — Assembly 

IVPGEN is a two-stage process. In stage I„ the IVPGEN rracro calls in the control books 
of the standard and selected SCP functions. The generated job stream (input for stage 
II) is SYSPCH output. You may assign SYSPCH to a card punch, a magnetic tape unit, a disk 
extent, or a diskette. If, however, parameters UTL=YES and PCHADDE are both specified, 
you may assign SYSPCH to a card punch only. For cardless systems, do not specify PCHADDE 
if you specify OTL=YES. 

If SYSPCH is assigned to a card punch, you must remove the punched deck (output of 
stage I) from the stacker and put it in a card reader as input to stage II (IVP 
execution).. The last card (an object END card) of the deck must be removed. 

If SYSPCH is assigned to either tape,, disk, or diskette there is an automatic 
transition from stage I to stage II provided that the required job control statements are 
punched (see Figure 3-1) . 

At the very beginning of system generation, you can assemble the IVPGEN macro with the 
option VERIFY=YES, under control of the IBM-supplied supervisor. This will provide you 
with a diagnostic of the specified parameters. It also provides you (if specified in the 
IVPGEN assembly) with a job stream to delete the unused IVP books. 

This job can be run to free up space in the source statement library. The advantage 
of specifying VERIFY=YES is that you have ample time to correct any specification errors 
before the IVP procedure is actually performed at the end of system generation,. 
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IVPGEN-Staqe II — Execution 

Before it actually starts executing the verification, stage II successively performs 

• LISTIO ALL to display (on SYSLST) all the devices that are supported 

• MAP to display (on SYSLOG) the sizes of the partitions assigned 

• DSERV of all the assigned libraries to display in alphabetical order (on SYSLST) the 
names of all the transients, phases, modules, macros, and (optionally) procedures, 
that the system comprises. 

IVPGEN Parameters 

A. Component Dependent 



ABD={YES) 
\ NO/ 



The ABEND dump IVP is always autoiratically generated (YES is 
forced) unless RERUN=YES is specified in which case ABD=NO is 
the default 



ASL-f YES ) 
I NO/ 



The display, verify, replace,, and delete capabilities of the 
ESERV program are automatically verified (YES is forced) unless 
RERUN=YES is specified, in which case the default for ASL is KO. 



CAF=/ no) 
\YESf 



Specify if Cataloged Procedures Support is to be verified. 



EMA= 



\YESf 



Specify if the DOS/VS 1401/1M40/1460 Emulator program is to be 
verified. 



E]yiANAME=name 



Specify the phase name of the user-generated 1401/1440/1460 
emulator program. 



EMATA=cuu 



Device address of the tape unit assigned to 1400 tape unit 1, 
Specify only if tape functions are to be verified. 



EMATSN=SYSnnn 



Name of the logical unit assigned to 1400 tape unit 1. Specify 
only if tape functions are to be verified. 



EMATYPE= 



(1401 ) 
<1401G> 
(1440 ) 



Specify the type of verification procedure to be selected. 
Refer to the section entitled "EMA-1401/1440/1460 Emulator" for 
a detailed description of the EMATYPE operands. 



EMACCS= 



lYESj 



Specify if CS control cards support is required in the 
user-generated 1401/1440/1460 emulator program (CTLCARD=CS in 
the emulator EMSUP macro instruction) . 



EME=^ NO) 



YES J 



Specify if the DOS/VS 1410/7010 Emulator program is to be 
verified. 



--^ 



EMENAME=name 



Specify the phase name of the user-generated 1410/7010 emulator 
program- 



EMETA=cuu 



Device address of the tape unit assigned to 1400 tape unit 1, 
channel 1. Specify only if tape functions are to be verified. 



EMBTSN=SYSnnn 



Name of the logical unit assigned to 1400 tape unit 1, channel 
1. Specify only if tape functions are to be verified. 



-- 1 



E20=| no) 
lYESf 



Specify if the System/360 Model 20 Emulator program generation 
is to be verified. 



E20NAME=name 



Specify the phase name of the user-generated System/360 Model 20 
Emulator program. 



OLT=/ NO ) 

\yes/ 



Specify if the IVP job for OLTEP is to be generated. 
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A. Component Dependent (continue d) 



PWP= 



i NO) 

\YES/ 



+- 

\ NO/ I ^ 



Specify if the IVP job for POWER/VS is to be generated. 



UTL= 



The disk functions of the system utilities are autoiratically 
verified (YES is forced) unless RERUN=yES is specified in which 
case the default for UTL is NO. 



UTLDfl=(cuu,cuu) 



Specify the disk device addresses of two work disks for use by 
the disk functions of the systeir utilities. 



UTLDRT=nnnn 



Disk extent relative track number of a one-track work space on 
the disk work volumes. 



UTLDT= p330 ) 
\nnnn| 



Specify the device type of the two work disks. 



UTLDV= (nnnnnn, irmrnnmni) 



Specify the volume serial numbers of the two work disks in the 
same order as specified by the UTLDA parameter. 



UTLT= 



\YESJ 



Specify if the tape functions of the system utilities are to be 
verified. 



UTLTA=cuu 



Specify the device address of the tape drive on which a work 
tape is to be mounted. 



UTLTM= (CO 






Specify the tape device mode. If this parameter is omitted, 
a 9-track, 1,600 BPI tape is assumed. 



UTLZ= 



(YESl 



Specify if the data cell functions of the system utilities are 
to be verified.. 



UTLZA=cuu 



Specify the device address of the data cell drive that contains 
a work cell to be used by the Installation Verification Program. 



-+ 



UTLZCN=n 



Specify the number of the work data cell. 



UTLZRT=nnnn 



Specify the data cell extent relative track number of a 
one-track work space on the data cell work volume. 
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B_j Component Independent 



DELUNSD=IYES) 
\ NOf 



Specify if a delete job is to be generated for those IVP books 
that are not used in this assembly of the IVPGEN iracro. 



DELUSED=( NO) 
lYESJ 



Specify if a delete job is to be generated for all tne IVP books 
that are used in this assembly of the IVPGEN macro. 



IPTADDP= 



iooc) 

(cuuf 



Device address of the system input device. SYSRDR and SYSIPT 
will be reset to this address after completion of IVP stage II. 



LSTABDP= 



(OOE) 
(cuuf 



Device address of the system printer during the execution of 
IVP stage II. 



PCHAEDR=cuU 



Device address of the sys 
IVP stage II. If no veri 
the system utilities is d 
specified. For cardless 



tern card punch during the execution of 
ficaticn of disk-to- card functions of 
esired, this parameter should not be 
systems, PCHADDR must be omitted. 



RERUN=( m) 
\YES( 



Specify YES if this IVP i 
if one or more SCP functi 
RERUN=YES is specified, a 
and UTL.- 



s a rerun. A rerun can be performed 
ons are to be verified again. If 
default of NO is taken for ABD, ASL, 



VERIFY=( N0\ 
(YESI 



Specification of YES caus 
generation of an IVP stag 
only job that is generate 
books (if DELUNSD=YES) . 



es a diagnostic to be made without 
e II job stream. In this case, the 
d is the delete job for the unused IVP 
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r 

IVP STAGE I INPUT — CREATION OF IVP STAGE II JOBSTREAW 



In cards 

// JOB IVPSTGl 

LOG 
// OPTION DECK 
// EXEC ASSEMBLY 

IVPGEN selected parameters 

END 
/ + 
/S 



On tape 

// JOB IVPSTGl 

LOG 
// PAUSE "OPERATOR PLEASE MOUNT A SCRATCH TAPE ON UNIT X'cuu'" 

MTC REW, X'cuu" 
ASSGN SYSPCH,X*cuu' Assign SYSPCH to tape 
// OPTION DECK 
// EXEC ASSEMBLY 

IVPGEN selected parameters 

END 
/* 

CLOSE SYSPCH, X'OOD' Close SYSPCH and reset to standard assignment 
// PAUSE OPERATOR PLEASE MOUNT TAPE ON UNIT X'cuu' AGAIN 
ASSGN SYSIN, X'cuu' Set to address of tape unit 
/& 



On disk or diskette 

// JOB IVPSTGl 

LOG 
// DLBL IJSYSPH,, ' IVP STAGE II JOBSTREAM' Stage 1 output 
// EXTENT SYSPCH, nnnnnn,, „ ,nnnn,nnnn (see Note) 

// DLBL IJSYSIN,'IVP STAGE II JOBSTREAM' Stage 2 input 
// EXTENT SYSIN„nnnnnn, , ,nnnn,nnnn (see Note) 

ASSGN SYSPCH, X^'cuu' Assign SYSPCH to disk 
// OPTION DECK 
// EXEC ASSEMBLY 

IVPGEN selected parameters 

END 
/ + 

CLOSE SYSPCH, X'OOD' Close SYSPCH and reset to standard assignment 
ASSGN SYSIN, X'cuu' Set to disk address 
/6 

Note: The extent information and volume sequence numbers in the two EXTENT statements 
must be identical. 

Figure 3-1. Example of IVP Stage I Job Control Statements 
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PREPARING THE IVP JOB STREAM 



I 



Setup Requireirents 

SYSOOl, SYS002, EYS003, and SYSLNK must be assigned to disk work extents. 

If SYSPCH is assigned to a disk device, the allocated extent must be at least 4 cylinders 
on a 2316 disk pack, 3 cylinders on a 3336 disk pack, 7 cylinders on a 3348 data module, 
or 2 cylinders on the disk pack of a 3350 direct access storage. 

A minimum of 14K bytes of real storage must be allocated to the partition in which the 
IVP jobs are to be executed. If POWER/VS functions are to be verified at the same time, 
add the storage requirements for POVER/VS to the allocated real and virtual storage. 
These reguirements are given in DOS/VS POWER/VS Installation Guide and Reference 
GC3 3-6048. 

Operating Instructions 

Prepare the following job control statements: 

Step 1 

// JOB ASSEMBLE IVPGEN 

// ASSGN SYSPCH,, X'cuu' (can be card, tape, disk, or diskette) 

// ASSGN SYSOOl, X'cuu* work file 

// ASSGN SYS002,X'cuu' work file 

// ASSGN SYS003„X'cuu" work file 

// EXEC ASSEMBLY 

IVPGEN (selected parameters) 

END 
/* 
/£ 

Step 2 

If SYSPCH is assigned to a card punch, remove the last card from the deck. This is the 
(object) END statement, which cannot be processed by Job Control. Put the remaining 
cards in the hopper of the reader, assigned to SYSIN. Press START and EOF. IVP stage II 
will now be executed. 

Step 3 

If SYSPCH is assigned to tape, disk,, or diskette, close SYSPCH (if SYSPCH was assigned to 
tape, ready the tape device again) and assign SYSIN to the same tape, disk or diskette 
device. This will start the execution of IVP stage II. 

Stage II successively executes a: 

LISTIO ALL to display (on SYSLST) all the devices supported. 
MAP to display (on SYSLOG) the partition sizes assigned. 

DSERV DSPLYS ALL to provide a sorted printout of the library directories. 

Furthermore,, stage II performs the standard IVP functions that is verification of the 
ABEND dump,, of the Assembler and Utility Programs, and of all optional functions 
selected. It also produces the delete jobs for used and/or unused IVP books (if 
specified) - 
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ABD - The ABEND Dump 

The ABD function forces an abnormal end-of-job condition. A real storage duirp is printed 
on SYSLST, 

ASL 

This IVP function verifies the display and update capabilities of the ESERV program. 
Example of SYSLOG Output 

BG // JOB IVPASL TEST ESERV 
DATE 11/04/73> CLOCK 07/22/56 

BG * IDENTIFICATION : ESERV PROGRAM 

BG * PURPOSE : TO SHOW THE DISPLAY AND UPDATE CAPABILITYS OF ESERV 

BG * FUNCTIONS TESTED : DISPLAY, VERIFY, REPUCE, DELETE 

BG * SET UP REQUIREMENTS : SYS002 MUST BE ASSIGNED 

BG * TO DISK, SYSLST MUST BE ASSIGNED 

BG * NORMAL COMPLETION MESSAGES : * IVPASL COMPLETED +++++++++++++++++++++ 

BG * LISTING CONTAINS INSTRUCTIONS ON HOW TO 

BG * CHECK FOR SUCCESSFUL EXECUTION 

BG * MODULES TESTED/ USED : IPKAD, IPKVA, IPKVD, IPKVE, IPKVF, 

BG * IPKVG, IPKVI, IPKVK, IPKVM 

BG * INPUT DESCRIPTION : TWO DSPLY CONTROL CARDS, THE SECOND 

BG * FOLLOWED BY ) COL, ) VER, ) REP, ) DEL 

BG * AND ) END CARDS, AN EDITED MACRO 

BG * C IVPASLS ) IN THE E SUBLIBRARY 

BG * OUTPUT DESCRIPTION : A DISPLAY OF IVPASLS, A DISPLAY OF IVPASLS, 

BG * UPDATED BY THE ) REP CARDS, AN UPDATE SURVEY 

BG * ******************************************************************** 

BG * IVPASL COMPLETED ++++++++++++++++++-1-+++++ 

BG EOJ IVPASL 

DATE ^^ /Oh/73, clock 07/24/59, DURATION 00/02/02 
BG ICOOA ATTN. OC. 
BG 



E xample o f SYSLST Output 

// JOB IVPASL TEST FSERV DATE 1 1 /Oi+/ 73 tCLOCK 07/22/56 

* *****sje********* ******************************************* **************** 

* IDFNTTFICATION: FSFRV PROGRAM 

* PUPPOSF: TO SHOW THE DISPLAY AND UPDATE CAPABILITYS OP ESERV 

* FUNCTIONS TESTED: DISPLAY, VERIFY, REPLACE, DELETE 

* SET UP REQUIREMENTS: -SYSOOl, SYS0C2 MUST BE ASSIGNED 

* TO DISK, SYSLST MUST BE ASSIGNED 

* NORMAL COMPLETION MESSAGES: * IVPASL COMPLETED ++++++++++ + -»•+++++++■»- 

* LISTING CONTAINS INSTRUCTIONS ON HOW TO 

* CHECK ^OR SUCCESSFUL EXECUTION 

* MODULES TESTED/USED: I PKAD , I PKVA ,1 PKVD, I PKVE, I PKVP, 

* IPKVG, IPKVI , IPKVK, IPKVM 

* INPUT PESCPIPTION: TWO DSPLY CONTROL CARDS, THE SECOND 

* FOLLOWED BY ) COL, ) VER, ) REP, ) DEL 

* AND ) END CARDS, AN EDITED MACRO 

* (IVPASLS) IN THE E SUBLIBRARY 

* OUTPUT DESCRIPTION: A DISPLAY OP IVPASLS, A DISPLAY OP IVPASLS, 

* UPDATED BY THE ) REP CARDS, AN UPDATE SURVEY 

* ****************************************************************************** 

// EXEC ESERV 
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DSPLY F.IVPASLS 



E.IVPASLS 



75/01/0* 



E.IVPASLS 



CATALS A.IVPASLS 
MACRO 
I VPASL S SPP I , EPP2 , 6PP3 , CPP4 , £PP5 , 6PP6 , 
CKMl>,CKW2>tCKH3° 
' DISK OPERATING SVSTEM 

■ IVPASLS - 5745-SC-ASM - RELEASE 28.0 

■ /* START OF SPECIFICATIONS •♦**♦•«•♦*♦♦♦***•*♦*«*•♦♦*♦*•••*♦ 



1 
2 
3 

5 

6 

7 * 

8 •01* MODULE-NAME = IVPASLS 

9 ♦ 

10 *01* DESCRIPTIVE NAME 



U * 

12 • 

13 ♦ 

14 *0l* FUNCTION « AS FOLLOWS. 



INSTALLATION VERIFICATION PROCEDURE 
TEST PROGRAM FOR ESERV PROGRAM 
-SOURCE BOOK- 



15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 

26 * 

27 ♦Ol* NOTES = CHANGE ACTIVITY 



THIS MACRO IS USED AS INPUT TO THE ESERV PROGRAM IN THE 
INSTALLATION VERIFICATION PROCEOORt (IVP). TO CHECK THAT 
THE IVP WAS SUCCESSFULt COMPARE THE TWO DISPLAYS OF THIS 
MACRO THE IVP PRINTS. THEY OUGHT TG RE EQUAL, EXCEPT 
FOR TWO STATEMENTS. THE STATEMENT NUMBER OJ7500 

AIF (T'GPP2 EQ •OM.TWO 
IN THE FIRST DISPLAY WILL BE CHANGED TO - 

AIF (T'CPP2 EQ '0'). THREE 
IN THE SECOND DISPLAY. THE STATEMENT NUMBER 014000 

MNOTE • VALUE OF CCPP5 IS £PP6' 
IN THE FIRST DISPLAY WILL BE DELETED IN THE SECOND DISPLAY 



3 DENOTES CHANGE ACTIVITY FLAGS. D IS SYSTEM IDENTIFIER 

FOR DOS. MEANING OF THE THIRD CHARACTER IS: A = APAR, 

M = PTM, L = NEW DEVELOPMENT. ALL OTHER CHARACTERS ARE 

FOR IBM INTERNAL USE. 



28 
29 
30 
31 

32 ♦ 

33 ♦01* CHANGE ACTIVITY = AS FOLLOWS. 



34 
35 
36 
37 

38 

39 

40 

41 

42 

43 

44 .ONE 

45 

46 tGBLA 

47 .TWO 
48 

49 CGfiLB 

50 .THREff 
51 

52 CGBLC 



CHANGE DESCRIPTIONS. 

NFW MODULE - FIRST RELEASE 28. 



/* END OF SPECIFICATICNS *********************************** 
GBLA CGBLA 
GRLP tGBLB 
GBLC CGBLC 
LCLA &LCLA 
LCLB CLCLB 
LCLC CLCLC 



ANOP 

AIF 

SETA 

ANOP 

AIF 

SETP 

ANOP 

AIF 

SFTC 



IT'SPPl EQ 

appi 



(T'£PP2 EO 
( 1) 



(T'6PP3 EQ 
•SPP3' 



00250000 
OOSIOOOO 
00310000 
00320000 
00330000 
00340000 
00342000 
00344000 
00346000 
00348000 
00348100 
00348200 
00348600 
00349000 
00349100 
00349200 
00350900 
00352900 
00355000 
00356800 
00357200 
00357600 
00360900 
00361500 
00361900 
00364000 
00366100 
30368200 
00371300 
00372400 
00374500 
.28301 00376600 
00378600 
00380600 



00650000 
00700000 



10750000 
00800000 



00850000 
00900000 



53 .FOUR 
54 

55 £LCLA 

56 .FIVE 
57 

58 SLCLB 

59 .SIX 
60 

61 tLCLC 

62 .SEVEN 
63 

64 

65 .EIGHT 

66 

67 

68 .NINE 

69 

70 

71 

72 .TEN 

73 

74 

75 .ELEVEN 

76 

77 



ANOP 

AIF 

SETA 

ANOP 

AIF 

SETB 

ANOP 

AIF 

SETC 

ANOP 

AIF 

MNOTE 

ANOP 

AIF 

MNOTE 

ANOP 

AIF 

MNOTE 

MNOTE 

ANOP 

AIF 

MNOTE 

ANOP 

MNOTE 

MEND 



(T'£KW1 EQ •OM.FIVE 
£KW1 

(T'6KW2 EO 'CM. SIX 
(1) 

(T'£KW3 EO "OM. SEVEN 
•tKW3' 

(T«£PP4 EO 'OM. EIGHT 
•VALUE OF ££PP4 IS £PP4 • 

«T'£PP5 EQ 'O'l.NINE 

• VALUE OF ££PP5 IS £PP5 ' 

(T'£PP6 EO 'O'J.TEN 

• VALUE OF ££PP5 IS £PP6 ' THIS STATEMENT W 

• VALUE OF ££PP6 IS £PP6' 

(NOT £GBLB AND NOT £LCL8) . ELEVEN 

• VALUE OF £ePP2«££KU2 IS £;PP2 + SKH2' 

• S£PP2 AND/OR ££KW2 NOT SPECIFIED' 



00950000 
01000000 

01050000 
01100000 

01150000 
01200000 

01250000 
01300000 

01350000 
01360000 

01370000 

ILL BE DELETED 01400000 

01450000 

01500000 
0155QOO0 

01600000 
01750000 
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DSPLY F.IVPASLS 



E.IVPASLS 



CATALS A.IVPASLS 
MACRO 
I VPASL S aPP 1 1 CPP2 ,CPP3 , EPP'. , 6PP5 , CPP6 , 
CKW1-,CKW2»,&KH3= 
' DISK OPERATING SVSTFM 

' IVPASLS - ST'tS-SC-ASM - RELEASE 28.3 
■ /* START OF SPECIFICATIONS *♦*♦*•♦**♦♦♦♦♦♦**»♦♦♦♦***♦*♦♦*♦♦* 



1 
2 
3 

5 
6 

7 ♦ 

8 ♦01* HOOULE-NAHE = IVPASLS 

q » 

10 *0l* DESCRIPTIVE NAME 



11 * 

12 ♦ 

13 * 

lA *01* FUNCTION = AS FOLLOWS. 



INSTALLATION VERIFICATION PROCEDURE 
TEST PROGRAM FOR ESERV PROGRAM 
-SOURCE BOOK- 



15 ' 

16 < 

17 1 

18 * 

19 i 

20 * 

21 * 

22 < 

23 < 

24 * 

25 * 

26 * 

27 ♦01* NOTES 



THIS MACRO IS USED AS INPUT TO THE ESERV PROGRAM IN THE 
INSTALLATION VERIFICATION PROCEDURe tIVP». TO CHECK THAT 
THE IVP WAS SUCCESSFUL, COMPARE THE TWO DISPLAYS OF THIS 
MACRO THE IVP PRINTS. THEY OUGHT TO BE ECUAL, EXCEPT 
FOR TWO STATEMENTS. THE STATEMENT NUMBER 007500 

AIF (T'ePP2 EQ 'OM.TWO 
IN THE FIRST DISPLAY HILL BE CHANGED TO - 

AIF (T'CPP2 EQ 'OM. THREE 
IN THE SECOND DISPLAY. THE STATEMENT NUM8CR DIAOOO 

MNOTE • VALUE OF EGPPS IS CPP6' 
IN THE FIRST DISPLAY WILL BE DELETED IN THE SECOND DISPLAY 

CHANCE ACTIVITY 
3 DENOTES CHANGE ACTIVITY FLAGS. D IS SYSTtM IDENTIFIER 
FOR DOS. MEANING OF THE THIRD CHARACTER IS: A = APAR, 
M = PTM, L = NEW DEVELOPMENT. ALL OTHER CHARACTERS ARE 
FOR IBM INTERNAL USE. 



28 
29 

30 
31 

32 ♦ 

33 *0l* CHANGE ACTIVITY = AS FOLLOWS. 



!■ CHANGE DESCRIPTIONS. 

fc NFW MODULE - FIRST RELEASE 28. 

I< 

* /* END OF SPECIFICATIONS ********♦****«*♦**♦#**♦*♦***♦****** 

GBLA CGBLA 

GBLR CGBLB 

GBLC flGRLC 

LCLA CLCLA 

LCLB 6LCLB 

LCLC &LCLC 

ANOP 



34 
35 
36 
37 

38 

39 

40 

41 

42 

43 

44 .ONE 

45 

46 SGBLA 

47 .TWO 
48 

49 GGBLR 

50 .THREE 
51 

52 aCBLC 



AIF 

SETA 

ANOP 

AIF 

SETB 

ANOP 

AIF 

SETC 



(T'&PPl EO 
SPPl 



(T«&PP2 EO 
( 1) 



'O'l .THKEE 



( T 'SPP3 EO '0') , 



00250000 
00300000 

0031 onoo 

00320000 
00330000 
00340000 
00342000 
00344000 
00346000 
0034R000 
00348100 
00348200 
00348600 
00349001 
00349100 
00349200 
00350900 
00352900 
00355000 
00356800 
00357?0O 
00357600 
00360900 
00361500 
0U3hl901 
00364000 
00366100 
00368200 
003 7 3300 
0037^400 
00374500 
00 37660-1 
00378600 
00380600 



00650000 
00701001 



00R5QC00 
11900010 



E.IVPASLS 










53 


• FOUR 


ANOP 




54 




AIF 




55 


£LCLA 


SETA 




56 


.FIVE 


ANOP 




57 




AIF 




58 


tLCLB 


SETB 




59 


.SIX 


ANOP 




60 




AIF 




61 


CLCLC 


SETC 




62 


.SEVEN 


ANOP 




63 




AIF 




64 




MNOTE 




65 


•EIGHT 


ANOP 




66 




AIF 




67 




MNOTE 




68 


.NINE 


ANOP 




69 




AIF 




70 




MNOTE 




71 


.TEN 


ANOP 




72 




AIF 




73 




MNOTE 




74 


•ELEVEN 


ANOP 




75 




MNOTE 




76 




MEND 



(T«£KW1 EQ 'OM.FIVE 
&KH1 



iT«6KW2 EO 'OM.SIX 
(II 



tT'6KW3 EQ 'OM. SEVEN 
•£KW3* 



(T'£PP4 EQ 'O'). EIGHT 

• VALUE OF ESPP4 IS £PP4' 



tT«ePP5 EO 'OM.NINE 

• VALUE OF C&PP5 IS ePP5 ' 



(T'£PP6 EQ 'O'J.TEN 

' VALUE OF &CPP6 IS CPP6 • 



(NOT &GBLB AND NOT &LCLBI . ELEVEN 

' VALUE OF C&PP2+66KW2 IS {lPP2*dKW2' 



• £6PP2 AND/OR £&KW2 NOT SPECIFIED' 



00950000 
01000000 



01050000 
01100000 



01150000 
01200000 



01250000 
01300000 



01350000 
01360000 



01370000 
01450000 



01500000 
01550000 



01600000 
01750000 
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E.IVPASLS 



75/11/06 



UPDATE SURVEY 
I COL 73f6 
) VER 003000 

* IVPASLS - 5745-SC-ASM 

* IVPASLS - 5745-SC-ASM 
) VER 007000*1,8 

* TWO 

.TWO ANOP 
) REP 007500 

AIF 

AIF 
} DEL 014000 

MNOTE 
) END 



tT«tPP2 EQ 
(T'CPP2 EO 



RELEASE 28.0 
RELEASE 28.0 



•0').TWO 
•0'). THREE 



VALUE OF £CPP5 IS CPP6 • THIS STATEMENT WILL BE DELETED 01400000 



.VERIFY CARD 
.ACTUAL STMT 



.VFRIFY CARD 
.ACTUAL STMT 



.OELFTED 
.ADOFD 



END OF UPDATE SURVEY 



/* 



THIS TERMINATES THE ESERV PROCESSING 



* IVPASL COMPLETED +♦♦+++++ + ♦.++♦♦ 
EOJ IVPASL 



DATE 11/04/73,CLa;K 07/24/59f DURATION 00/02/02 



STOP - 
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CAP - Cataloged Procedures 

This function verifies the cataloging of a procedure into the procedure library and its 
subsequent execution- 

Setup Requirement s 

& procedure library must be allocated. Eight or more unused blocks must be available in 
the member space. 

Example of SYSLOG Out put 

BG // JCe Iv/PCAPI 

DATE 11/04/73, CLOCK 07/1^/36 

QQ * ************************************************************* 

BG * IDENTIFICATION : IVPCAPl 

BG * PURPOSE : CATALOGING OF A PROCEDURE 

BG * F'>iCTIONS TESTED : CATALP 

BG * SET UP REQUIREMENTS : SYSTEM WITH PROCEDURE 

BG * LIBRARY WITH MORE THEN SIX UNUSED BLOCKS IN MEMBER SPACE 

BG * MODULES TESTED : MAINT 

BG * OUTPUT DESCRIPTION : SYSTEM STATUS REPORT PRODUCED 

BG * BY $LIBSTAT 

BG * ************************************************************** 

BG EOJ IVPCAPl 

DATE 11/0i+/73^ CLOCK 07/16/20, DURATION 00/01/^+3 
BG // JOB IVPCAP2 

DATE 11/04/73, CLOCK 07/16/28 
BQ * *************************************************************** 

BG * IDENTIFICATION : IVPCAP2 

BG * PURPOSE : EXECUTION OF A CATALOGUED PROCEDURE 

BG * FUNCTIONS TESTED j EXECUTION OF CATALOGUED PROCEDURE IVPCAPl 

BG * WHEREBY AN ASSEMBLED PROGRAM IS ASSEMBLED, 

BG * LINK EDITED, TEMPORARILY CATALOGUED INTO 

BG * THE CORE IMAGE LIBRARY AND EXECUTED 

BG * SET UP REQUIREMENTS : SYSLNK, SYSOOl, SYS002, SYS003 MUST BE 

BG * ASSIGNED 

BG * MODULES TESTED : JOB CONTROL 

BG * OUTPUT DESCRIPTION : PRINTING OF DATA LIST 

Bg * **************************************************************** 

BG * BEGIN OF PROCEDURE 

BG * END OF PROCEDURE 

BG EOP IVPCAPl 

BG IVPCAPl STARTED +-H-+++++++++++++-H-+-H-+ 

BG IVPCAPl COMPLETED SUCCESSFULLY +++++++++++++++++++++++ 

BG EOd IVPCAP2 

DATE 11/0if/73, CLOCK 07/20/29, DURATION 00/03/59 
BG // JOB IVPCAP3 

DATE 11/04/73, CLOCK 07/20/36 
BG * DELETE IVPCAPl FROM PROCEDURE LIBRARY 
BG EOJ IVPCAP3 

DATE 11/04/73, CLOCK 07/21/17, DURATION 00/00/41 
BG ICOOA ATTN. OC. 
BG 
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Example of SYSLST Output 



// JPB IVPCAPl 

* identification: IVPCAPl 

* purpose: cataloging of a procedure 

* FUNCTIONE tested: CATALP 

* SET UP requirements: system with procedure 

* library with more than six unused blocks in member SPACE 

* modules tested: maint 

* output description: system status report produced 

* BY $LIBSTAT 

// exec maint 



DATE 04/19/74, clock 09/28/22 



CATALP IVPCAPl 



STATUS REPORT 



DATE: 10/28/76 



STARTING 




NEXT 




LAST 


ADDRESS 




ENTRY 




ENTRY 


C H R 


C 


H R E 


C 


H R 



TIME: 14.44 

DIRECTORY LIBRARY BLOCKS 

ENTRIES 
ACTIVE ALLDCTD ACTIVE DELETD AVAIL 



COND . DIR. TRACKS 
LIMIT OR LIBRARY 
BLOCKS CYLINDERS 



SYSRES VOL.SER.l 1 1 1 1 1 

PROCEDURE DIRECTORY 194 00 01 
LIBRARY 194 05 01 



1 94 11 08 

195 01 20 



194 04 44 
197 18 61 



// EXEC PSERV 



VERSION 0.0 



PROCEDURE LIBRARY 



* BEGIN OF PROCEDURE 
// OPTION LINK 

// EXEC ASSEMBLY 

ENTRY 

// EXEC LNKEDT 

* END OF PROCEDURE 
/ + 



EOJ IVPCAPl 



DATE 04/1 9/74. CLOCK 09/26/35, DURAT ION OO/OO/i; 



// job ivpcap2 

»: identification: ivpcaps 

* purpose: execution qf a catalogued prqcecure 

* functions tested: execution of catalogued procedure IVPCAPl 

* WHEREBY AN ASSEMBLER PROGRAM IS ASSEMBLED, 

* LINK EDITED, TEMPORARILY CATALCGUED INTO 

* THE CORE IMAGE LIBRARY AND EXECUTED 

* SET UP requirements: SYSLNK, SYS00 1,SYS002.SYS003 MUST BE 
^- ASSIGNED 

* MODULES tested: JOB CCNTRQL 

* OUTPUT description: printing of data LIST 

// EXEC PRQC= IVPCAPl 

* BEGIN OF PRCCEOURE 
// OPTION LINK 

// EXEC ASSEMBLY 



DATE 04/1 9/74, CLOCK 09/28/37 
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EXTERNAL SYMeOL DICTIONARY 



SYMBOL 



TYPE 



TEST SD (CSECT) 

IJDFZ22Z ER (EXTRN) 

IJDF222Z SC (CSECT) 

IJC-2IZ0 ER (EXTRN» 



ID ADDR LENGTH LD-ID 

01 007DOO OOOICO 

02 

03 000000 000026 

04 



SYMBOL ID LENGTH 

IJDP0012 FF. 000030 



DUMMY SECTION DICTIONARY 



LOC OBJECT CODE 
007000 



ADDRl AD0R2 STMT 



SOURCE STATEMENT 



DOS/VS ASSEMBLER REL 30.0 05.29 74-0A-19 



007D00 05A0 

007D02 4 1 BO A0D8 

007D06 181B 
007008 OAOC 

007D0A 181B 
007DOC 9180 1002 
007D1 471 A014 
007014 OA07 

007D16 0700 

007016 

007018 4110 A1A6 

007D1C 4500 A026 

007D20 00007CA8 

007024 00007078 

007028 0A02 



07002 
070DA 



00002 
07D16 



07EA8 
0702 8 



1 TEST START 32000 

2 IVPCAPS 

3+* IVPCAPS - 5754-SC-LBR - RELEASE 28.0 

4+* 

S+* /* START OF SPECIFICATIONS ♦****#****«*****«*«**♦♦♦******♦*♦*******»* 

6+* 

7+*0 1* M0OULE-NAME= IVPCAPS 

e+* 

9+*01* OESCRIPTI VE-NAME=INSTALLATI ON VERIFICATION PROCEDURE 
10+* TEST FOR CATALOGUED PROCEDURES 

1 1 + * 

12+*01* NOTES = CHANGE ACTIVITY 

13+* a DENOTES CHANGE ACTIVITY FLAG. O IS SYSTEM IDENTIFIER FOR DOS. 

14+* MEANING OF THE THIRD CHARACTER IS - A=APAR ,M=PTM. 1=NEW 

15+* DEVELOPMENT. OTHER CHARACTERS ARE FOR IBM INTERNAL USE. 

16+* 

17+*01* CHANGE ACTIVITY = AS FOLLOWS 
18+* CHANGE DESCRIPTIONS 

19+* NEW MODULE - FIRST RELEASE 28 

20+* WRONG SEARCH IN PCIL 

21+* 

22+**** END OF SPECIFICATIONS ************♦♦*********♦*******************/ 
23+START BALR 1 0. 

24+ USING *.10 

25+ LA REG.TYPECCB 

26+* SUPVR COMMN MACOS - EXCP - 5745-SC-SUP - REL. 28.0 



2 7+ LR 

28+ SVC 

29+* SUPERVISOR 



,REG 



30+ 

31 + 

32 + 

33+ 

34+* IOCS - 

3 5+ 

36+ 

37 + 

3e+IJJ00004 

39 + 

40+ 

41+ 



WAIT - 5745-SC-SUP - REL. 

LR 1 .REG 

TM 2{ 1 ),X«80» 

EO *+6 

SVC 7 

OPEN - 5745-SC-IOX - REL 28.0 

CNOP 0.4 

DC OF • • 

LA l,=C'$$eOPEN • 
SAL 0.*+4+4*(3-l ) 

DC A( INPUT) 

DC A(OUTPUT) 

SVC 2 



EM 



04000028 
05000028 
06000028 
07000028 
08000028 
09000028 
10000028 
1 1000028 
12C0002E 
13000028 
14000028 
15000028 
16000026 
17000C2€ 
18000028 
19000028 
20000028 
21000028 
22000028 
23000028 
24000028 
25000026 
26000028 
150 50028 
50000025 
55010028 
12000028 
39000025 
5A000025 
S7000025 
60000025 
12000028 
20000025 
22000025 
46000025 
54000025 
64000025 
64000025 
74000025 



007D2A 5810 A1B6 

007D2E 58F1 0010 

007D32 4SEF 0008 

007D36 5810 Al EA 

00703A 58F1 0010 

007D3E 45EF OOOC 



07EB8 
00010 
00008 

07EBC 
OOOIO 
OOOOC 



43+* IOCS - GET - 5745-SC-IOX - REL 29.0 

44+LABEL L lt=A(INPUT) GET DTF TABLE ADDRESS 

45+ L 15.16(1) GET LOGIC MODULE ADDRESS 

46+ EAL 14.8(15) BRANCH TO GET ROUTINE 

47+* IOCS AND DEVICE INDEPENDENT I/O - PUT - 5745-SC-IOX - REL. 29.0 

48+ L l.=A(OUTPUT) GET DTF TABLE ADDRESS 

49+ L 15.16(1) GET LOGIC MODULE ADDRESS 



50+ 



BAL 



14. 12< 15) 



BRANCH TO PUT ROUTINE 



12000029 
42000025 
75000025 
78000025 
05000029 
1S000025 
3-5 54000025 
3-5 55000025 



Module 3: Installation Verification Procedure 149 



LOC OBJECT CODE 



ACORl AD0R2 STMT 



SOURCE STATEMENT 



OOS/VS ASSEMBLER BEL 30.0 09.29 74-04-19 



007D42 47F0 A 028 07D2A 

0C7D46 700 
00 7Di-8 

007D48 411C AlAE 
007D4C 4500 AC56 
0070?0 00007DA8 
007D5A 00007D78 
00 7058 0A02 
007D5 A 4 1 BO A0F6 
007D5E 5 0B0 AOEO 

*** EFROR *** 
00 706 2 41 BO AOOe 

007D66 1818 
007D68 OAOO 

007D6A 181B 

007D6C 9180 1002 00002 

007D70 4710 AC74 07D76 

007074 0A07 

007076 OAOE 





51 + 






B 


LABEL 




52+* 


IOCS 


AND DEVICE I NDE PENDANT 




53 + 






CNOP 


0.4 




54+ END 




DC 


OF* 0* 


07EB0 


55+ 






UA 


l.=C*$$BCLOSE« 


07058 


56+IJJC0007 


SAL 0.*+4+4*<3-l ) 




57+ 






DC 


A(INPUT) 




58+ 






DC 


A(OUTPUT) 




5 9+ 






SVC 


2 


07DF8 


60+ 






LA 


REG.TYPNCCW 


07DE2 


61 + 






ST 


REG,TYPECCB+8 



I/O - CLOSE - 5745-SC-IOX - R EL . 28 .0 



62+ LA REG.TYPECCB 

63+* SUPVR COMMN MACOS - EXCP - 5745-SC-SUP - REL. 28.0 



5745-SC-SUP 



64+ 


LR 


1 .REG 


65+ 


SVC 





66+* 


SUPERVISOR ■ 


-WAIT - 574 


67+ 


LR 


1 .REG 


68+ 


TM 


2( 1 ),x«eo' 


69+ 


BO 


*+6 


70+ 


SVC 


7 



71+* SUPVR COMMN MACROS - EOJ - 5745-SC-SUP - REL. 28.0 



33000026 
0810002G 
20000025 
£!;00C02£ 
46000025 
54000025 
64000025 
64000025 
74000025 
35000028 
36000028 

36050028 
15050028 
5000002S 
EM 55010023 
12000028 
39000025 
54000025 
57000025 
60000025 
40000028 
50C0C02E 



74+* IOCS AND DEVICE INDEPENDANT I/O - OTFPR - 5745-SC-IOX 



REL. 30.0 



007:) -'8 

007D78 ooooeocooooo 

007D7E 00 

007D7F 03 

C07080 00007DAO 

OOTDS-i 00000000 

007D88 00 

007D89 000000 

007D8C 08 

0C7D8D 10 

C07DeE 09 

007D8F 09 

C07D90 00007E58 

00709^ OOOOCOOO 

007096 0700 

007D9A 4700 0000 OC 

007D9E OOOC 

0070AO 09007E5e200000SO 



oooorr 
cooooo 

C000C2 
000003 
COOOO^ 



75 + 

76+OUTPCT 
77 + 



DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 

DC 
DC 

NOPR 
NOP 
CC 

CCW 



OD'O' 

x'ooooaooooooo" 

ALl(O) 

ALl (3) 

A(*+32) 

4X'00« 

ALl (0) 

VL3(IJ0FZZZZ) 
X'08« 
ALl (16) 
ALl (9) 
ALl (9> 

A( IN+0) 
4X«00' 



2X»00' 
9.IN+0.X'20* .80-0 



78+ 

79+ 

80+ 

81 + 

82+ 

83+ 

84+ 

85+ 

86+ 

87+ 

88+ 

89+ 

90+ 

91 + 

9 2+ 

93+IJJZOOll EQU * 

94+* IOCS AND DEVICE INDEPENDANT I/O 

95+IJDPD012 DSECT 

DS CL2 

DS CLl 

DS CLl 

DS CL2 



RES. CCUNT, COM. BYTES BTS JJ 
LOGICAL UNIT CLASS 
LOGICAL UNIT 

CCW ADOR. JJ 

CCB-ST BYTE.CSW CC* ADDRESS JJ 

SWITCH 3 4-0 

ADDR OF LOGIC M0DUL3-8 



DTF TYPE (PRINTER) JJ 

SWITCHES 

NORMAL COMM. CCCE 4-0 

CONTROL COMM. CODE 4-0 

ADDRESS OF DATA IN IQAREAl 

BUCKET 3-5 

PUT LENGTH IN REG12 (ONLY UNDEF. 
LOAD USER POINTER REG 

NOT USED 3-5 

4-0 



- PRMOD - 5745-SC-IOX 



REL. 2 9.0 



96+IJCP0012 
97+ I J DPI 01 2 
98+IJDP2012 
99+IJCP0012 



RESIDUAL COUNT 
COMMUNICATION BYTE 1 
COMMUNICATION BYTE 2 
CSW STATUS BYTES 



02870030 
60000025 
61510026 
70000025 
70200028 
71000028 
71200028 
717SC027 
76800025 
77580028 
77eOCC25 
78000027 
78400027 
76800025 
64000025 
84600025 
86400025 
89600025 
91200027 
92000025 
01290029 
1620002S 
16400025 
16600025 
16800025 
17000025 
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LOC OBJECT CODE 



ADDRl A0DR2 STMT 



SOURCE STATEMENT 



DOS/VS ASSEMBLER REL 30<0 09< 29 74-04-lS 



ooooce 
cooooa 

000009 

cooooc 

COOOOD 
OOOOIC 
000014 
0000 15 
000016 

00001 7 

00001 8 

ooooic 

000020 
000022 
000026 
000027 
000028 
000029 
00002C 
00002D 
00002E 
OOOOOC 



000000 CA32 

000002 0000 

000004 0A32 

C00006 0000 

000008 0A32 

OOOOOA OOOC 

OOOOOC 47F0 FOIA 

OOOOIO C9DlC4CeE9E9E9E9 

000018 2800 

OOOOIA OAOO 
OC OOIC 9180 1C02 
000020 4710 F026 
C00024 OA07 
000026 07FE 





100+IJDP3012 


DS 


CL2 


LOGICAL UNIT ADDRESS 








17200025 




101 + 


DS 


CLl 


NOT USED 










17400025 




102+1 JDP4012 


DS 


CU3 


ADDRESS CF CCW 










17600025 




10 3+ 


OS 


CLl 


STATUS BYTE 










17800025 




104+ 


DS 


CL3 


CSW CCW ADDR. 










1800002S 




10S+IJDM1012 


DS 


CL4 


ADDRESS OF LOGIC MODULE 4- 


•0 


18050027 




106+1JDPS012 


OS 


CLl 


DTF TYPE 










18400025 




107+IJDP6012 


DS 


CLl 


SWITCHES 










ieeocc25 




108+IJDP9012 


OS 


CLl 


NORMAL COMMAND CCDE 








18800025 




109+IJDPA0 12 


DS 


CL 1 


CONTROL COMMAND CCDE 








19000025 




110+IJDP7012 


OS 


CL4 


ADDRESS OF lOAREA 1 








19200025 




11 1 + IJDP8012 


DS 


CL4 


BUCKET 










19400025 




112+1 JCPE012 


OS 


CL2 


L l2f4RECSIZE 










19600025 




113+IJDPC012 


OS 


CL4 


LA &IOREG.0<14) 










19800025 




114+IJCPE012 


DS 


CLl 


BUCKET FOR PRTOV 


IF ASA 


CH 


9 




20000025 




1 1S+IJDPF012 


DS 


CLl 


BUCKET FOR PRTOV 


IF ASA 


CH 


12 




2020002E 




116+IJDPG012 


DS 


CLl 


COMMAND CODE 










21000025 




117 + 1JDPI-C12 


OS 


CL3 


ADDRESS lOAREA 2 










21200025 




118+IJDPI 012 


DS 


CLl 


FLAGS =X«20' 










21400025 




119+ 


DS 


CLl 


NOT USED 










21600025 




120+IJDPJ012 


OS 


CL2 


COUNT 










21800025 




121+1JDF2ZZZ 


csecT 














22000025 


00000 


122 + 


USING 


IJOP0012. 1 












24800025 


coooo 


123+ 


USING 


*.15 












2500CC25 




124+ 


SVC 


IJ0L6012 


CONTROL ERROR 










26000025 




125 + 


DC 


1M«0' 












26200025 




126+ 


SVC 


I J0L6012 


PRTOV ERROR 










27000025 




127+ 


OC 


IH«0« 












27200025 




128+ 


SVC 


IJOL60 12 


GET ERROR 










27400025 




129+ 


DC 


1H« 0' 












27600025 


OOOIA 


13C + 


B 


tJOPR012 


BRANCH TO PUT 










27800025 


9 


131 + 


OC 


CL8«IJDFZ22Z» 


MODULE NAME 






4- 


■0 


28000027 




132+ 


OC 


X'2800> MODULE 


CHANGE LEVEL 




aDM014 57 


280 50028 


OOOIA 


133+IJDPf;012 


EQU 


* 












28400025 




134+ 


SVC 


IJ0L7012 


EXCP 










58800025 


00002 


135+ 


TM 


IJOPl012.IJOLe012 


WAIT CHANNEL END 






4- 


-0 


59400027 


00026 


136+ 
137+ 


BO 
SVC 


♦ ♦6 

7 












59600025 
59800025 




136 + 


BR 


IJ0L4012 


BACK TO USER 






3-9 


60250026 


OOOOB 


139+IJDL1012 


EQU 


11 


REG 11 






•»_ 


-3 


69600025 


OOOOC 


140+1JDL2012 


EQU 


12 


REG 12 










70000025 


OOOOD 


141+IJCL3012 


EQU 


13 


REG 13 










70200025 


OOOOE 


14 2+IJDL4012 


EQU 


14 


REG 14 










7C40002S 


OOOOF 


143+IJDLS012 


EQU 


15 


REG 15 










70600025 


00032 


144+IJDL6012 


EQU 


50 


ABEOJ 










70800025 


00000 


14S+1JDL7012 


ECU 





EXCP 










71000025 


00080 


146+IJ0Le012 


EQU 


x»e0' 












71200025 


00040 


147+IJ0L5012 


EQU 


X»40« 












71400025 


00020 


148+IJDLA012 


EQU 


X«20' 












71600025 


00008 


149 + IJCLe012 


EQU 


X'08» 












71800025 


00010 


150+1 JDLC012 


EQU 


X« 10« 












72000025 



Module 3: Installation Verification Procedure 151 



LOC OBJECT CODE 



ACDRl ADDR2 STMT 



SOURCE STATEMENT 



DOS/VS ASSEMBLER REL 30.0 09.29 74-04-19 



00004 
00006 
00 00 1 
00002 
00068 
OOOFE 
OOOOB 
OOOBF 
000F8 
00040 
0000 1 
00015 
00038 
00023 
00005 
0008D 
OOOBD 
OOOID 
OOOOD 
OOOCD 
00030 



007DA8 

007DA8 

007DA8 OC008C0000O0 

00 7DAE 

007DAF 1 

007DB0 00007DC8 

007DB<: 00000000 

007DB8 00 

007OB9 000000 

007OBC C2 

007DBD or 

007DeE 02 

0C7DBF 02 

007DCO 00007ES8 

007OC4 00 

007DC5 007D48 

007DCe 02007E5e2C000050 

007DD0 4700 0000 'COOOO 

007DD4 4700 0000 00000 

007DDe 0000 



07DDA 



0070DA 0000 

007DOC 0000 

0070De 0000 

007DEO OC 

007DE1 04 

007DE2 00 

007DE3 007DFO 



15 1+IJDLC0 12 
IS2+IJDLE012 
IS3+IJDLF012 
154+1 JDLG012 
155+1 JDLH012 
156+IJDL 10 12 
157+IJDLJ012 
15e+IJDLK012 
159 + IJCLL012 
160+1JDLM012 
161+IJDLN012 
162+IJDM601Z 
163+IJDM6012 
164+IJCJM012 
165+1 JD05012 
166+IJD8D012 
167 + IJCBC012 
I6e+1JD1D012 
169+IJD0D012 
170+1 JDCD012 
171+1 JDV2012 
172+TEST 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
CSECT 



X«04' 
X«06* 
X'Ol* 
X»02« 
X" 8B» 
X«FE« 
X'OE' 
X'BF* 
X'F8' 
X'40» 
1 
X' 1 5" 
56 

X«23» 
X«05« 
X'SD* 
X'BD* 
X* ID" 
X«OD« 
X" CD* 
48 



CCB+3 ERROR PASSBACK BITS 3-9 

CCB+2 ERROR PASSBACK BITS 3-9 

REG 1 3-9 

DISP FOR SWITCHES 4-0 

ASOCFLE CISP IN CTF 4-0 

FDiSS COMMAND 4-0 
LINE POSITION ZERO FOR 3525 4-0 

TEST FOR CHANNEL 9 4-0 

TEST FOR CHANNEL 12 4-0 

LINE 3 4-0 

LINE 1 4-C 

LINE 26 4-0 

DISP IN PUNCH DTF 4-0 



173+* IOCS AND DEVICE INDEPENDANT I/O - OTFCO - 574E-SC-I0X - REL. 30.0 



174+ 

175+INPUT 

176+ 

177 + 

178 + 
179+ 

180 + 

181 + 
182+ 
183 + 
184+ 
185+ 
186+ 
187+ 
188 + 

189+IJCX0013 
190+ 
191 + 
192+ 
193+IJ JZOO 13 EQU * 

194+* SUPVR COMMN MACROS - CCB - 5745-SC-SUP - REL. 28.0 



DC 
DC 
DC 
DC 
DC 

DC 
CC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 

CCW 
NOP 
NOP 
DC 



00 '0' 

X 'OOOOSOOOOOOO' 

ALl (0) 

AL 1 ( 1 ) 

AC IJCX0013) 

4X' 00" 
ALl(O) 

VL3 ( IJCFZIZO ) 
X'02« 
ALl (0 ) 
ALl (2) 
AL 1( 2) 
AC IN) 
ALl (0) 
AL3(END) 

2. IN.X '20* .80 



X' 0000* 



RES. COUNT, COM. B'VTES STATUJJ 
LOGICAL UNIT CLASS 
LOGICAL LNIT 

CCW ADDRESS BDL29g4J 

CCB-ST BYTE.CSW CCW ADDR . 
SWITCH 3 4-0 

ADDRESS OF LOGIC MODULE 3-3 

DTF TYPE (READER) JJ 

SWITCHES 

NORMAL COMM.CODE 
CNTROL CCMM.CODE 
ADDR. OF lOAREAl 

JJ 
EOF ADDRESS JJ 

LOAD USER POINTER REC. 
MOVE lOAREA TO WCRKA 



195+TYPECCB 

196+ 

197+ 

198+ 

199 + 

200+ 

20 1 + 



DC 
DC 
DC 
DC 
DC 
DC 
DC 



XL2'0' . 

XL2*0* 

XL2*0* . 

ALl(O) 

AL1(4> 

XLl 'O* 

AL3(TYPECCW) 



RESIDUAL COUNT 

COMMUNICATI CNS BYTES 
CSW STATUS BYTES 

LOGICAL UNIT CLASS 
LOGICAL UNIT 

CCW ADDRESS 



72200025 
7240CC2S 
72600025 
72800025 
73000025 
73200025 
7340C025 
73600025 
73650026 
73700026 
73750026 
73750527 
73751027 
73751527 
73752027 
73752S27 
73753027 
73753527 
73754027 
73754 52 7 
73755027 
75800025 
01220030 
44800025 
45200028 
49800025 
50000025 
50400029 
51C0002S 
51200027 
53600025 
53940028 
55200025 
5S40C025 
59600025 
60000025 
60600028 
60800028 
62600025 
63000025 
63800025 
64000025 
85800025 
07100028 
45000028 
50000028 
51000028 
52000028 
53000028 
54000028 
55000028 



152 DOS/VS System Generation 



LOC OBJECT CODE 



ADDRl ADDR2 STMT 



SOURCE STATEMENT 



DOS/VS ASSEMBLER RE L 30.0 09.29 74-04-19 



007DE6 00 

0070E7 OOOOOO 

007DEA OOOOCOOCOOOO 

0070FO 09007EOCOOC00025 

007DF6 09007E2500000033 

C07E00 C9E507C3C1D74040 

007E25 C9E5D7C3C1D74040 

OOTESe 

0'-7EA8 5B5BC2D6C7C5D540 

007FB0 5B5BC2C3D3D6E2C5 

007EB8 00007DA8 

007EBC 00007078 



20 2+ 

20 3+ 



DC 
CC 



B* 00000000' 
AL3<0) . 



STATUS BYTE 
CSW CCW ADDRESS 



204+TYPECCW CCW 9.MS6ST .0 .L" MSGST 



205+TYPNCCW 

206+MSGST 

2 07+ MS GEN 

208+REG 

209+lN 

210 

21 1 

212 

213 

214 



CCW 9.MSGEN,0.L'MSGEN 

DC C'lVPCAP STARTED ++++++++++++♦+++♦+++• 

DC C'lVPCAP COMPLETED SUCCESSFULLY ++++++++++++++++++++' 

EQU 1 1 

CS CL80 

END START 

=C«$$BDPEN • 

= C'$$-BCLOSe' 

=A( INPUT) 

=A(OUTPUT ) 



56000028 
57000028 

45000028 
46000028 
4700C02€ 
48000028 
49000028 
50000028 



RELOCATION DICTIONARY 



ESDID FOR 


ESDID FOR 


TYPE 


LENGTH 


ADDRESS 


ADDR CON 


REF SYMBOL 








C 1 


+ 01 


A 


4 


007D20 


01 


+ C1 


A 


4 


007D24 


1 


+ 01 


A 


4 


007DE0 


01 


+ 01 


A 


4 


007D54 


01 


+ 01 


A 


4 


00 7080 


01 


+02 


V 


3 


0070 69 


01 


+ 01 


A 


4 


007D90 


01 


+ 01 


CCW 


3 


007DA1 


01 


+01 


A 


4 


007DBO 


01 


+ 04 


V 


3 


007069 


01 


+ 01 


A 


4 


007DC0 


01 


+01 


A 


3 


007DC5 


01 


+ 01 


CCW 


3 


007DC9 


01 


+ 01 


A 


3 


007DE3 


01 


+ 01 


CCW 


3 


007DF1 


01 


+ 01 


CCW 


3 


007DF9 


Oi 


+ 01 


A 


4 


007EB8 


01 


+ 01 


A 


4 


007EEC 
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CROSS-REFERENCE PAGE 6 

SYMBOL LEN ID VALUE DEFN REFERENCES 74-04-19 

END 00004 01 007D46 00054 0188 

IJCX0013 ooooe CI ooroce ooieg oi7e 

IJDBD012 OOOOl OOOOBD 00167 
IJOCD012 00001 OOOOCD 00170 

IJDFZ2ZZ 00001 03 OOOOCO 00121 
1JDJM012 00001 000023 00164 
IJDLA012 OOOOl OC0020 00148 

iJDLBOia OOOOl oooooe 00149 

IJDLC012 OOOOl 000010 00150 

IJDLD012 OOOOl 000004 00151 

1JDLE012 OOOOl 000006 00152 

IJOLF012 OOOOl 000001 00153 

IJDLG012 OOOOl 000002 00154 

IJDLH012 OOOOl 00008E 00155 

IJDLI012 OOOOl OOOOFE 00156 

IJDLJ012 OOOOl OOOOCB 00157 

IJDLK012 OOOOl OOOOBF 00158 

IJDLL012 OOOOl OOO0F8 00159 

IJDLM012 OOOOl 000040 00160 

IJ0LN012 OOOOl 000001 00161 

IJDL1012 OOOOl OOOOOB 00139 

1JDL2012 OOOOl oooooe 00140 

IJDL3012 OOOOl OOOOOD 00141 

IJDL4012 OOOOl OOOOOE 00142 0138 

IJDL5012 OOOOl OOOOOF 00143 

IJDL6012 OOOOl 000C32 00144 0124 0126 0128 

IJDL7012 OOOOl OOOOCO 00145 0134 

UDLBOIS OOOOl 000080 00146 0135 

IJDL9012 OOOOl 000040 00147 

IJOM1012 00004 FF 000010 00105 

IJDM6012 OCOOl 000015 00162 

IJDM8012 OOOOl 000038 00163 

IJDPA012 OOOOl FF 000017 00109 

IJDPBC12 00002 FF 000020 00112 

IJ0PC012 00004 FF 000022 00113 

IJDPD012 OOOOl FF OOOOCO 00095 

IJDPE012 OOOOl FF 000026 00114 

IJDPF012 OOOOl FF 000027 00115 

IJDPG012 OOOOl FF 000028 00116 

1JDPH012 OCC03 FF 000029 00117 

IJ0PI012 OOOOl FF 00002C 00118 

IJDPJ012 0C002 FF 00002E 00120 

IJDP0012 00002 FF 000004 00099 

IJDPR012 OCOOl 03 OOOOIA 00133 0130 

IJDP0012 00002 FF OOOOCO 00096 0122 

IJDP1012 OOOOl FF 000002 00097 0135 

IJDP2012 OOOOl FF 000003 00098 

IJDP3012 00002 FF 0000C6 00100 

IJDP4012 00003 FF 0000C9 00102 

IJOP5012 OCOOl FF 000014 00106 

IJDP6012 OOOOl FF OOOOIS 00107 
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CROSS-REFERENCE 



LEN ID VALUE DEFN 



REFERENCES 



74-04-19 



IJDP7012 


00004 


FF 


000018 


001 10 








IJDP8012 


00004 


FF 


OOOOIC 


001 11 








1JDP9012 


OOOOX 


FF 


ooooie 


ooioe 








I JDV2012 


00001 




000030 


00171 








IJO0D012 


00001 




OOOOOD 


00165 








IJD05012 


00001 




000005 


00165 








I JD1D012 


00001 




000010 


00168 








IJD8D012 


00001 




00008D 


00166 








I JJC0007 


00004 


01 


007 04 C 


00056 








IJJOO004 


OOC04 


CI 


007D1C 


00038 








IJJZOOll 


00001 


01 


007DAe 


00093 








IJJZ0013 


OOOOI 


01 


007DDA 


00193 








IN 


00C80 


01 


007E5g 


00209 


0087 


0092 


0186 


INPUT 


00006 


01 


007DA8 


00175 


0039 


0057 


C213 


LABEL 


00004 


01 


007D2A 


00044 


0051 






MS GEN 


00051 


01 


007E25 


00207 


0205 


02 05 




MSGST 


00037 


01 


007E00 


00206 


0204 


0204 




OUTPUT 


00C06 


CI 


007078 


00076 


004 


0058 


0214 


REG 


00001 




000 OB 


00208 


0025 


0027 


0030 


START 


00002 


01 


007DCO 


00023 


0210 






TEST 


00001 


01 


007DC0 


00001 


0172 






TYPECCe 


00002 


01 


007D0A 


00195 


0025 


0061 


0062 


TYPECCW 


00008 


01 


007DFO 


00204 


0201 






TYPNCCW 


00008 


01 


007DFe 


00205 


0060 






=A< INPUT ) 
















00004 


CI 


007EB8 


00213 


0044 






=A (OUTPUT) 
















00004 


01 


007EEC 


00214 


0048 






=C«$>BOPEN • 
















00008 


01 


007EA8 


00211 


0037 






=C'$$BCLOSE' 
















00C08 


01 


007EBC 


00212 


0055 







0060 0061 0062 0064 0067 
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DIAGNOSTICS ANC STATISTICS 



PAGE 10 



STMNT ERROR NO. MESSAGE 

61 IPKI82 ALIGNMENT ERROR IN OPERAND Z 



74- 04- IS 



THE FOLLOWING MACRO NAMES HAVE BEEN FOUND IN MACRO INSTR.UC TI ONS 
IVPCAPS EXCP WAIT OPEN GET PUT CLOSE 



OPTIONS FOR THIS ASSEMBLY - ALIGN. LIST, XREF. LINK. DECK. EOECK 



THE ASSEMBLER WAS RUN IK 135046 BYTES 
END OF ASSEMBLY 



ENTRY 
// EXEC LNKEDT 



JOB IVPCAP2 04/19/74 

ACTION TAKEN MAP REL 
LIST AUTOLINK IJCFZIZO 

LIST ENTRY 



DOS LINKAGE EDITOR DIAGNOSTIC OF INPUT 



04/19/74 PHASE XFR-AD LOCORE HICORE OSK-AO ESD TYPE LABEL LOADED REL-FR 

PHASE*** 040078 040078 0402CB 019 OD 09 CSECT TEST 040078 038378 RELOCATABLE 

CSECT IJOFZZZZ 040238 040238 

CSECT IJCFZIZO 040260 040260 



^ END OF PROCEDURE 
EOP IVPCAPl 
// EXEC 
I 

12 
. 123 
1234 
12 345 
123456 
1234567 
12345678 
123456789 



EOJ IVPCAP2 



DATE 04/19/74. CLOCK 09/30/2 6. DURATION 00/01/Sl 



// JOB IVPCAP3 

* DELETE IVPCAPl FROM PROCEDURE LIBRARY 

// EXEC MA INT 



DATE 04/ 19/74. CLOCK 09/30/3 



DELETP IVPCAPl 



STATUS REPORT 



;tarting 




NEXT 


ADDRESS 




ENTRY 


C H R 


c 


H R 



DATE: 10/28/76 TIME: 14.44 

LAST DIRECTORY LIBRARY BLOCKS COND. DIR. TRACKS 

ENTRY ENTRIES l-'MIT OR LIBRARY 

C H R E ACTIVE ALLOCTD ACTIVE DELETD AVAIL BLOCKS CYLINDERS 



SYSRES VOL. SER. Ill 111 
PROCEDURE DIRECTORY 

LIBRARY 



194 00 01 194 OC 11 08 1 94 04 44 09 

194 OS 01 195 1 20 197 18 61 



EOJ IVPCAP3 



DATE 04/19/74. CLOCK 09/3C/3S.DURA TION 00/00/05 
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EMA - 1401/1440/1460 Emulator 



Functions Tested 

Three verification procedures are provided with the eir.ulator: 

• One to be used with an emulator generated for a 1401 or a 1460, with the following 
options: advanced programming, sense switches, and 1400 console. 

• One to be used with an emulator generated for a 1401 or a 1401G or a 1460 without the 
above options. 

• One to be used with an emulator generated for a 1440 with the options advanced 
programming and sense switches. 



IVPGEN MACRO OPTIONS 

i no) Specify if the DOS/VS 1401/1440/1460 Emulator program is to be 
EiyiA=\YEs/ verified. 

R equired Parameters 

(1401 ) 
EMATYPE=<1440 / Specify the required verification procedure. 



1401G 



1401 
1440 
1401G 



Verification procedure for a 1401/1460 emulator with options. 
Verification procedure for a 1440 emulator. 

Verification procedure -for a 1410/1460 emulator without options, 
or verification procedure for a 1401G emulator. 



EMANAiyiE=X Specify the phasename under which the emulator is cataloged in the core 
image library. 

Optional Parameters 

EMACCS=| no) Specify if CS control cards support is required in the user-generated 

\yes) 1401/1440/1460 emulator program (CTLCARD=CS specified in the EMSUP iracro 
instruction) . 

Specify the following two parameters only if you want to verify the tape functions. 

EMATSN=SYSnnn Specify the logical name of the tape device assigned to the 14 00 tape 
unit 1. This unit must have been defined in an EMTAPE emulator macro 
instruction. Do not specify this parameter if spanned tape format has 
been specified {TPSUP=SPANNED in the EMSUP emulator macro instruction) , 
or if the emulator does not emulate the tapes {TPSUP=NCNE in the EMSUP 
macro instruction) - 

EMATA=cuu Device address of the tape drive. Specify only if EMATSN^SYSnnn is also 
specified. 

Note that only one emulator program can be executed during one IVP run and that, 
conversely,, this emulator can execute only one of the verification procedures. 

In addition to testing the 1400 CPU functions and the operator communication 
functions,, the verification procedures: 

• Read data from, the System/370 device assigned as 1400 card reader. 

• Punch data on the System/370 device assigned as 14 00 card punch. 

• Print the data read from the 1400 card reader on the System/370 device assigned as 
1400 printer. 
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If the Systeni/370 configuration includes a tape unit, the verification procedures (except 
those for the 1401G or the 1401/1460 without options) optionally write on and read froir 
tape in 1400 format (TPSUP=ORIGINAL or MIXED in the EMSUP emulator macro instruction) . 

The verification procedures contain 1400 object programs and data as well as tne 
DOS/VS control cards required to execute the emulator. You can perform the verification 
procedures with the emulator generated in accordance with your specifications and 
cataloged to the core image library. 

However, the verification procedures cannot be used with an emulator generated to 
handle: 

• column binary data 

• card image data 

• 51-column cards. 

A 1401/1440/1460 emulator must emulate real storage of a size of at least 4,000 bytes. 
A 1401G emulator must emulate real storage of a size of at least 4,000 bytes. 

SOFTWARE REQUIREMENTS 

Emulator Macro Options 

The following emulator instructions generate a minimum emulator to execute the 
verification procedures (does not apply to the 1401G emulator) : 

EMULATOR CPU=XXXX , CORE= 4 , ADVPROG= YE S , SENSE SW=YES , M0DEL=1 4 5 

EMSUP EMNAME=Eiy!SPL01,CCRDR=SYSRDR, X 

TPSUP=ORIGINAL,CONSOLE=YES 
EMRDR TODEV=2540 

EMPNCH FRCMDEV=140 2,TODEV=254 
EMPTR FRCMDEV=1403,TODEV=1403 

EMTAPE DEVADDR=SYS001,UNIT=1, X 

TYPEFLE=OUTPUT,RECFM=ORIGINAL,,ELKSIZE=8 
EMEND 
END 

Notes 

1. xxxx in the EMULATOR macro can be either 1401,1440, or 1460. 

2. The EMTAPE macro specification is not required if no tape functions are to be 
verified. 

For a 1401G the minimum emulator is generated as follows: 

EMULATOR CPU=14 01G^CORE=4 ,ADVPROG=YES, SENSESW=YES, M0DEL=14 5 

EMSUP EMNAME=EMSPL01,CCRDR=SYSRDR 

EMRDR TODEV=2540 

EMPNCH FRCMDEV=1402,TODEV=2540 

EMPTR FROMDEV=1403,TODEV=1403 

EMEND 

END 

The logical names of the System/370 devices assigned as 1400 reader, punch, and printer 
are by default SYSIPT, SYSPCH, and SYSLST. If you specified logical names in the form 
DEVADDR=SYSnnn, be sure that these devices relate to the same devices as SYSIPT, SYSPCH, 
and SYSLST. 
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HARDWARE REQUIREMENTS 

A Central Processing Unit equipped with: 

• The IBM Compatibility Feature 4457 for Models 125 and 135 

• The IBM Compatibility Feature 4457 or 4458 for Model 145 

• Standard instruction set 

• One tape drive, if the tape functions are to be verified 

STORAGE REQUIREMENTS 

The amount of storage required depends on what you specify when generating your errulator. 
The emulator described in the section "Software Requireirents" takes up approximately 
27,500 bytes of storage, 

OPERATING INSTRUCTIONS 

1 . Setup Requiremen ts 

None, if tape functions are not to be verified. Otherwise, mount a scratch tape on 
the tape unit assigned to 14 00 tape unit 1. 

2. Operating Instructions 

Type in START in response to message 

EN0 21D IVPEMA HALT IAR=nnnnnn 
AAR=00001/2 EAR=00001/2 



EMB - 1410/7010 Emulator 



Functions Tested 

• 1410/7010 CPU functions 

• Operator communication functions 

• Console operations 

• Tape functions - 1400 format (optional) 

IVPGEN MACRO OPTIONS 

EMB=^ NO) Specify if the DOS/VS 1410/7010 Emulator program is to be 
lYES/ verified. 

Required Parameter 

EMBNAME=x Specify the phase name under which the emulator is cataloged in the core 
image library. 

Optional Parameters 

EMBTSN=SYSnnn Specify the logical name of the System/370 tape device assigned to 1400 
tape unit 1, channel 1. 

EMBTA=cuu Eevice address of the tape drive. Specify only if EMATSN=SYSnnn is also 
specif ied- 
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In addition to testing the 1410/7010 CPU functions and the operator comiruni cation 
functions, the verification procedures: 

• Read data from the Systerri/370 device assigned as 1400 card reader. 

• Punch data on the Systeni/370 device assigned as 14 00 card punch. 

• Print the data read from the 1400 card reader on the Systein/370 device assigned as 
1400 printer. 

If the System/370 configuration includes a tape unit the verification procedures 
optionally write on and read from tape in 1400 format {TPSUP=ORIGINAL or MIXED in the 
EMSUP emulator macro instruction) . 

The verification procedure comprises a 1400 object program and data as well as the 
DOS/VS control cards required to execute the emulator program. You can perform the 
verification procedures with an emulator generated in accordance with your specifications 
and cataloged to the core image library. 

The minimum amount of storage that can be handled by a 1410/7010 emulator is 40,000 
bytes- 

For a 1410 emulator the EMULATOR macro instruction must specify URCHAN=1 and 
OVERLAP=YES, in addition to the selected parameters. 

SOFTViARE REQUIREMENTS 

The following instructions will generate a minimum size emulator to execute the 
verification procedures: 

EMULATOR CPU=XXXX„CORE=40,CHAN=1„URCHAN=1 , OVERLAP=YES,MODEL=14 5 

EMSUP EMNAME=EMSPL10,CCRDR=SYSRDR, X 

TPSUP=CRIGINAL 
EMRDR TODEV=2540 
EMPNCH TODEV=2540 
EMPTR TODEV=1403 
EMTAPE DEVADDR=SYS001,UNIT=11, X 

TYPEFLE=OUTPUT,RECFM=ORIGINAL,BLKSIZE=80 
EMCNSL 
EMEND 

END 

Notes ; 

1. xxxx in the EMULATOR macro can be either 1410 or 7010. 

2. DO not specify OVERLAP=YES if CPU=7010 is specified. 

The logical names of the System/370 devices assigned as 1400 reader,, punch, and printer 
are by default SYSIPT,, SYSPCH and SYSLST. If you specified logical names in the form 
DEVADDR=SYSnnn„ be sure that these devices relate to the same devices as SYSIPT, SYSPCH, 
and SYSLST. 

HARDWARE REQUIREMENTS 

A Central Processing Unit equipped with: 

• The IBM Compatibility Feature 4458 for Models 145 

• Standard instruction set 

• One tape drive, if tape functions are to be verified. 
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STORAGE REQUIREMENTS 

The amount of storage required is dependent on what you specify when generating your 
emulator. The errulator described in the section "Software Requirements" takes up 
approximately 27,500 bytes of storage. 



OPERATING INSTRUCTIONS 

1 . Setup Require ments 

None, if tape functions are not to be verified. Otherwise, mount a scratch tape on 
the tape unit assigned to 1400 unit 1, channel 1. 

2 . Operating Instruc tio ns 
On display of message 

EP022D IVPEME HALT/BRANCH IAR=nnnnn AAR=xxxxx BAR=xxxxx D]y!OD=l 

• Type in START if nnnnn=06106. 

• Type in ECJ if nnnnn is not 06106. 



E20 - Systeiii/370 Model 20 Emulator 



Functions Tested 

The Installation Verification Procedure for the System/360 Model 20 emulator tests the 
following Model 20 functions: 

• CPU instructions. 

• Interrupt capability. 

• CPU data and address checking. 

• Operator communications. 

• I/O operations for each type of device the emulator program supports. 

Note : If the E20 verification procedure makes use of a read/punch device (2 520 or 2560) 
it can be used for only one run. For a following run it is necessary to assemble the 
IVPGEN macro again- 

IVPGEN MACRO OPTIONS 

E20= i no) Specify if the DOS/VS System/3 60 Model 20 Emulator program generation 
\yes/ is to be verified. 

Required Paraireter 

E2 0NAME=xxxx Specify the phase name under which the eirulator is cataloged in the core 
image library. Length of the phase name may be from four to seven 
characters - 
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HARDWARE REQUIREMENTS 

• A Central Processing Unit equipped with the IBM Coirpatibility Feature 7520 for Models 
125 and 135 and a standard instruction set. 

• One physical device for each Model 20 device eirulated. 

If the Systein/360 configuration comprises an MFCM, note that the emulation can either be 
performed on a System/370 MFCM or on the combination of a 3504/3505 and a 3525. The MFCM 
is emulated at DOS/VS level by two physical devices., therefore, enter two ASSGN commands. 



OPERATING INSTRUCTIONS 

1. Setup Requirements 

The system printer must be provided with a carriage control tape with punches in (at 
least) channels 1, 9, and 12. 

2 . Operating Instruction s 
In response to message 

E201D 01 STOP UL=99,PSW=0100062C,ESTR=OFFF 
type in EOJ to pass control to DOS/VS job control. 
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Example of SYSLOG Out put 



BG // JOB IVPE20 

DATE 11/0'4/73, CLOCK 25/11/^7 
BG * INSTALLATION VERIFICATION PROCEDURE FOR MODEL 20 EMULATOR ON S/370 
BG * YOU MUST ASSIGN EACH LOGICAL UNIT USED IN THE EMULATOR GENERATION TO 
BG * A VALID S/370 PHYSICAL DEVICE 

BG * FOR EXAMPLE M20 2501 CARD READER HAS BEEN GENERATED ON SYSOO^t 
BG * YOU MUST ENTER THE FOLLOWING DOS COMMAND 
BG * // AS5GN SYSOOi+.X'OOC' 

BG * ASSUMING THAT OOC IS A VALID CARD READER TYPE FOR EMULATION 
BG * YOU MUST DO THAT FOR M20 2501 2520/2560 ^kkl 1403/2203 AND TAPES 
BG // PAUSE PLEASE ENTER YOUR ASSGN COMMANDS NOW 
BG // ASSGN SYSOOt+^X'OOC 
BG // ASSGN SYS010,X'080' 
BG // ASSGN SYSOl 1 ,X'081 ' 
BG 

BG // PAUSE IT IS YOUR LAST CHANGE FOR ENTERING ASSGN COM^IANDS 
BG 

BG // EXEC EMUL3 

BG E220D ENTER 'DI ON' COMMAND FOR DEVICE INDEPdNDENCE^ IF NOT 'DI OFF' 
BG DI OFF 

BG E201D 01 STOP UL=99,PSW=000001F8,ESTR=0000 
BG S 

BG E201D 01 STOP UL=99,PSW=1000047E,ESTR=0001 
BG CF.S 

BG TAPES 081=SYS011 080=SYS010 
BG DISKS 002=AAAAAA 002=BBBBBB 

BG UR 2501=SYS00i+ 1 t+'+2=SYSPCH Itf03/2203=SYSLST 

BG E201D 01 STOP UL=g9,PSW=l 0000^+82, ESTR=0386 
BG S 

BG E201D 01 STOP UL=99/PSW:010004A6,ESTR=2501 
BG S 

BG E201D 01 STOP UL=99,PSW=01000'tEE,ESTR=14'f2 
BG S 

BG E201D 01 STOP UL=99,PSW=0100050E,ESTR=1403 
BG S 

BG E201D 01 STOP UL=99,PSW=0100051E^ESTR=0070 
BG S 

BG E201D 01 STOP UL=99^PSW=31 000542, ESTR=0002 
BG S 

BG E202D MOD20 PROGRAMMING ERROR UL=FA, I=07,PSW=010005F2 
BG CS SD=X'5F2' 

BG 5F2 FA440B820B82488006204A80068C4B80 
BG CS SD=X'B82' 

BG B82 00000000000000000000000000000000 
BG CS SA=CX'B82' ,X'000000001C').S 

BG E202D MOD20 PROGRAMMING ERROR UL=4A, I=08,PSW=n0006l 2 
BG HELP 

BG E2121 CONSULT 'UL' AND 'PSW' WHICH SPECIFY ERROR TYPE AND ADDRESS - 
BG E2121 - OF INSTRUCTION IN ERROR 

BG E2121 USE 'CS' COMMAND, FOLLOWED BY 'S' TO CORRECT THE ERROR 
BG E2121 IF THE ERROR PERSISTS, ENTER 'DF ED,TD,EDJ' TO CANCEL EMULATOR RUN 
BG CS RA=C8,X'0' ).S 

BG E202D MOD20 PROGRANMING ERROR UL=1A, I=08,PSW=1 100061A 
BG CS RA=C8,X' 0').S 

BG E201D 01 STOP UL=99,PSW=01000628,ESTR=0003 
BG S 

BG E201D 01 STOP UL=99,PSW=0100062C,ESTR=OFFF 
BG S 

BG E201D 01 STOP UL=99^PSW=0100062C,ESTR=OFFF 
BG EOJ 

BG * IVPE20 IS FINISHED 
BG EOJ IVPE20 

DATE 11/04/73, CLOCK 23''+0'08, DURATION OO'07'OO 
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Exam ple of SYSLST Out put 



// JOB IVPF20 DATfc IT /0^/73»CL0CK 23/33/07 

♦ ^^STALL*TlC^ VEt^lFICAKCN PRCCbCOftE FCR ^CDtL 2'J fc^'ULATCR CN S/J70 

♦ YOU WUST ASSIGN EACh tCGICAL LNIT IjStD li'* THE EVlLATCft GFNrKATION TO 

♦ A VALIC S/37C PHYSICAL CEVKE 

♦ FOR EXAMPLE M2C 2501 CARC KEADER HAS PEEN Gf.M-KArtO Urf SYSOHA 

♦ YOU t'LiST EMFR THE FOLLOWING CCS Ct-ff-ANL 

♦ // ASSGN SYSOO^fX'CCC' 

♦ ASSUt'ING THAT COC IS A VALIC CAKC RtArCK TYPE FlR EMULAIIC'm 

♦ VCU fUST DO TFAF FOR f'iC 2501 232C/25tO U'.2 14lj/2203 ANO TflPtiS 
// PAUSE PLEASE tMEH YCtR ASSGN CCf'I'ANOS .MO»v 

// ASSGN SYSCCfX'COC* 

// ASSGN SYSOlC.X'OaC 

// ASSGN SYSOll.X'Oei' 

// PAUSE IT IS YCUR LAST CHAKCE FCR ENTERINt, ASSGN LOKWAUDS 

// EXEC ENUL3 

01 OFF 

EC DC='//LC« 

LO 



SAr»PLE CUIPLT CAfA 
SAHPLE OUTPUT CATA 



SAMPLE OUTPUT CATA 
NCW SKIP TO C^A^NEL I 



THE 18 FIRST CHARACTERS OF ThiS LIKE ARE THE 
SAME AS THOSE OF THt PREVIOUS LINE 



NOW SKIP TC CHANNEL 12 
NOW SKIP 10 CHANNEL 09 

YOU HAVE GENERATED THE FCLLOWING MODEL 20 CONFIGURATION 

2S01 CARO READER 

U42 CARD PUNCH 

U03/22C3 PRINTER 
YOUR TAPE UMI ADDRESSES ARE = 60 fil 
YOU HAVE GENERATED STORAGE CONTROL FEAILRE 



* IVPE20 IS FINISHED 
EOJ IVPE20 



DATE 11 /0*/73tCLCCK 23/40/C8, DURATION 00/07/00 
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OLT - OLTEP 



Function Tested 

• The possibility of initializing online testing. 

OPERATING INSTRUCTIONS 
Action Messages 

01E105D ENTER-DEV/TEST/OPT/ 
Reply by typing in 

R 01, 'CANCEL* 
to terminate the execution of the OLTEP verification procedure. 

PWR - POWER/VS 

Function Tested 

The test checks that the generated version of POHER/VS functions in accordance with the 
specifications, 

SOFTWARE REQUIREMENTS 

POWER=yES must have been specified as a SUPVR macro paraireter when assembling tne 
supervisor. POWER/VS must be running while the test is being performed. 

Make sure that onljf POWEE/VS jobs are in the input stream. When a reader task is 
started, all reader input is read in and put into the POWEE/VS files. 

UTL - System Utilities 

Functions Tested 

Standard 

CLRDK Clear Disk 

CDKCD Copy disk to card 

CDKDK Copy disk to disk 

RCDDK Restore card to disk 

LVTOC VTOC display 

Note: If the PCHADDR parameter is not specified, CDKCD and RCDDK will not be verified. 
For cardless systems, PCHADDR must be omitted. 
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Optional 

• If UTLT=YES is specified in the IVPGEN macro: 

INTTP Initialize tape 
CDKTP Copy disk to tape 
RTPDK Restore tape to disk 

• If UTLZ=YES is specified in the IVPGEN macro: 

CLRDC Clear data cell 

CDKTP Copy data cell to tape (only if UTLT=YES is specified) 

RTPDK Restore tape to data cell 

HARDWARE REQUIREMENTS 

Required: 2 direct-access devices 
1 printer. 

Optional: 1 tape drive 

1 data cell drive 

1 card reader 

1 card punch 

1 diskette I/O unit. 
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Module 4: 1401/1440/1460 DOS/VS Emulator on 
Systein/370 - 5747- CC3 
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The 1i+0 1/1440/1460 Emulator Prograa for the IBH System/370, available as separate 
progranroing package, consists of a group of aacro instructions and object and load 
modules that are shipped in source statement, relocatable, and core image libraries. 
Two sample programs that test the norJcing of a 1401/1460 program, of a 1440 program, 
and of a 1401G program under the emulator are contained in the source statement library 
under the name Z.EMSPL01. The source cards of this program are cataloged under the name 
Z.EflSPLOIS, 

For detailed installation procedures, refer to 1401/1440/1460 DOS/VS Emulator on 
SYStem/370 Beference, GC 33- 5 3 84. 
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I Module 5: 1410/7010 DOS/VS Emulator on System/370 « 5747-CC3 
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The 1410/7010 Emulator Program, available as separate programming package, consists of a 
group of macro instructions and object and load modules that are shipped in source 
statement, relocatable, and core image libraries, ft sample program that tests the 
working of a 14 10 and 7010 program under the emulator is contained in the source 
statement library under the name Z.EHSPL10. The source cards of this program are 
cataloged under the name Z. EMSPL10S. 

For detailed installation procedures, refer to 1 410 /7010 D OS /VS Emulator on Sistem/370 
fiel§£ence, GC33-5385. 
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Module 6: Emulating the /360 Model 20 on Models 115, 125, 135, 
and 138-5745-SC4E20 
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MODEL 20 EMULATOR UNDER DOS/VS 



RELOCATABLE LIBRARY 



The Model 20 Emulator Program consists of a 
group of macro instructions and object and 
load modules that are shipped in the source 
statement, relocatable, and core image 
libraries. An installation verification 
program for postgeneration use is contained 
in the source statement library under the 
name Z.IISIVP20. In addition to the 
emulator, a data interchange function is 
supplied with the generation macro E.EMUDI. 



P ARTITION SIZE 

For further information, refer to the Model 
20 emulator publication. 



SOURCE STATEMENT LIBRARY 

r T 1 

I Number of | Number of | 
j Macros I Library Blocks | 
I I (Physical Records) | 
^ ^ ^ 

] 22 I 2,284 I 

L X J 

Macros 

E.EM1403 

E.EM1442 

E.EM2 0CHK 

E.EM20CONV 

E,EM2 0CPU 

E,EM20DI 

E.EM20END 

E.EM20MESS 

E,EM20PRHD 

E.EM20SYS 

E.EM20VRIF 

E.EM2152 

E.EM2203 

E,EM2311 

E.EM2400 

E.EM2501 

E-EM2520 

E.EM2560 

E.IISCR 

E.IISDC 

E.IISEDB 

E.IVPE20C 

Delete Statements 

DELETS E.EM1403 
DELETS E. EMI 442 
DELETS E.EM20CHK 



r T 1 

I Number of | Number of Library Blocks | 
I Modules j (Physical Records) | 
^ ^ ^ 

I 28 I 206 I 

L J J 

Module Name Bytes of Storage 



I IS CM 


1165 


IISCMS 


1117 


IISCP 


936 


IISCPS 


254 


USEE 


928 


IISDD 


1168 


IISDE 


340 


IISDF 


3328 


IISDFED 


1771 


IISDI 


1334 


IISDK 


3072 


IISDI 


342 


IISD2 


466 


IISD3 


470 


IISE4 


622 


USED 


5896 


IISHC 


424 


IISHFl 


2804 


IISHF2 


3204 


IISIE 


284 


IISIN 


1304 


IISMD2 


1487 


IISMF 


1060 


IISPD2 


348 


IISTD 


752 


IISTP 


1848 


IISTPH 


1161 


IISTR 


432 



Link-Edit Statements 

The ACTION CLEAR, PHASE, and INCLUDE 
statements are generated automatically, in 
accordance with your specifications, when 
the E.EM20END macro is assembled. For rr.ore 
detailed information on the link-edit 
statements, refer to the Model 20 emulator 
publication. 

Del ete Stat ements 

IIS is the identifier for both the basic 
Model 20 Emulator and the associated data 
interchange function. The statement 
DELETR IIS. ALL causes both the emulator and 
its data interchange function to be 
deleted. Unless this is desired, delete 
the modules one by one: 

DELETR IISCM 
DELETR IISCMS 



DELETS E.IISEDB 



DELETR IISTR 
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CORE IMAGE LIBRARY 



Macro 



r T 1 

I Number of | Number of | 
I Transients | Library Blocks | 
I ] (Physical Records) | 
y + ^ 

I 19 I 32 1 

L i J 



E.EMUDI 



Delete Stateirent 



DELETS E.EMUDI 



Transients 

$$BIISAL 
$$BIISAS 
$$BIISA2 
$$BIISCC 
$$BIISCD 
$$BIISCF 
$$BIISCS 
$$BIISDI 
$$BIISDP 
$$BIISLE 
$$BIISM1 
$$BIISM2 
$$BIISM3 
$$BIISM4 
$$BIISPR 
$$BIISRL 
$$BIISTD 
$$BIISTS 
$$BIISUR 



Delete Stateirents 

DELETC $$BIISAL 
DELETC $$BIISAS 



DELETC $$BIISUR 



DATA INTERCHANGE FUNCTION 



The Model 20 Data Interchange Function is 
generated as part of the Model 20 Emulator, 
under macro E.EMUDI. 



PARTITION SIZE 

For further information,, refer to the Model 
20 emulator publication. 



S OURCE STATEMENT LIBRARY 

r T 1 

I Number of | Number of | 
j Macros I Library Blocks | 
I I (Physical Records) j 
|. + ^ 

I 1 I 187 I 

L J. J 



RELOCATABLE LIBRAR Y 

r T 1 

I Nuirber of | Number of Library Blocks | 
I Modules I (Physical Records) j 
^ ^ ^ 

I 45 I 300 I 

L X J 



Module s 

IISCA 

IISDA 

USDS 

IISEQ 

IISFl 

IISF2 

IISF3 

IISF4 

IISIB 

IISIF 

IISILl 

IISIL2 

IISIL3 

IISILU 

IISIRl 

IISIR2 

IISIR3 

IISIR4 

IISMD 

IISMI 

IISML 

IISMO 

IISMR 

IISMS 

IISMSG 

IISSC 

IISSCI 

IISSCV 

IISSQ 

IISSl 

IISS2 

IISS3 

IISS4 

IISTK 

IISTKC 

IISTKE 

IISTKI 

IISTl 

IIST2 

IIST3 

IIST4 

IISVl 

IISV2 

IISV3 

IISVU 
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Link-Edit Statements 



Transients 



The link-edit statements are generated 
automatically, in accordance with your 
specifications, when the E.EMUDI macro is 
assembled. For irore detailed information, 
refer to the Model 20 emulator publication. 

Delete Statements 



$$BIISUC 
$$BIISUW 
$$BIISBI 
$$BIISBS 
$$BIISEX 
$$BIISFM 



IIS is the module identifier for both the Phases 
Model 2 Emulator and the associated data 

interchange function. The statement IISMTA 

DELETR IIS. ALL causes both the emulator and IISMTE 

the data interchange function to be IISMTC 

deleted. Data interchange modules must IISMTD 

therefore be deleted individually: IISMTE 

IISMTE 

DELETR IISCA IISMTG 
DELETR IISDA 



Delete Statements 



DELETR IISV4 



DELETC $$BIISUC 
DELETC $$BIISUM 



CORE IMAGE LIBRARY 



r r 1 

I I Number of | 

] I Library Blocks | 

I I (Physical Records) | 

Y -r + ^ 

I Transients | 6 | 8 | 

|. 1 ^ ^ 

I Phases | 7 | 7 | 

L X -L J 



EELETC $$BIISFM 



DELETC IISMTA 
DELETC IISMTB 



DELETC IISMTG 
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Module 7: CompOer IOCS Modules - 5745-SC-IOM 



Module Outline 



core -image library 179 

transients 179 

relocatable module naming 

conventions 180 

CDMOD iao 

DAMOD 18 9 

DIMOD 191 

ISMOD 1 92 

MTMOD 195 

system I/O modules 197 

PRMOD 198 

SDMOD 204 

name list for work file type 

modules {TYPEFLE=WORK) 207 

system I/O modules 2 07 

DUMOD 208 

required IOCS modules 209 
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Page of GC33-5377-6, Revised November 28, 1977, By TNL GN33-9230 

Module Index 



American National standard COBOL 
modules 

blocks, number of ,,... 179 

modules, number of ...««,... 179 

CDMOD (card modules) 180 

COBOL modules 

blocks, number of , 179 

modules, number of ................... . 179 

DAMOD (direct access modules) 189 

DIMOD (device independent modules) 191 

DUMOD 208 

ISMOD (index sequential modules) • 192 

macros, IBM-supplied 

CDMOD 180 

DAMOD 1 80 

DIMOD 180 

DUMOD 180 

ISMOD 1 80 

MTMOD 1 80 

PRMOD 180 

SDMOD 180 

magnetic tape module (MTMOD) ........... . 195 

MTMOD (magnetic tape modules).-. 195 

naming conventions, relocatable 

modules 180 

PL/I modules 

blocks, number of..... 179 

modules, number of..... 179 

printer modules (PRMOD). 198 

PRMOD. , ...,...., 198 

relocatable library 

blocks, number of......... 179 

modules, number of 179 

required IOCS modules 

blocks, number of 179 

real storage bytes 209 

modules, number of 179 

names 2 09 

SDMOD (sequential DASD modules) 20U 

SDMODxx for work file modules 204 

sequential DASD modules (SDMOD) 20U 

system I/O modules 

MTMOD 197 

SDMOD 207 

TRC parameter support (3800) 191, 198 
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r T T 

1 # TRANSIENTS | CIL BLOCKS j 
j. 1 ^ 

! 20 I 22 I 

L JL J 

CORE IMAGE LIBRARY 



T ransients 

$$BCBLIS ^ 

$$BCBLOP / 

$$BCBODA J> 

$$BCEUSR \ 

$$BCBUSW / 

$$BCOBER 

$$BC0BR1 

$$BFCMUL 

$$BPLOSE 

$IJKSOO 

$IJKS10 

$IJKS20 

$IJKS30 

$IJKS40 

$IJKS50 

$IJKS60 

$IJKS70 

$$B]yiU100 

$$BiyiU2 00 

$$B]yiU300 



COBCL D 



ANS/COBOL 



PL/I 



MPS Utilities 



Module 7 lists the names of the preassembled modules shipped by IBM in the relocatable 
library, their external storage requirements in library blocks, and the compilers that 
create linkage for their use. The size of these modules, if this should be needed to 
determine virtual storage requirements, may be calculated based on the module names 
(which give an indication of the specified parameters) and the values given under 
"Component Requirements - IOCS Eoutines" in Module 1 of this manual. 

No IOCS modules are required for FORTRAN. 

An X in a column headed by a compiler indicates that the particular module may be 
linked by that compiler to the problem program. For example, an x in the columns headed 
by COBOL and PL/I indicates that COBOL and PL/I link the module so identified. For 
assembler language programs, the user can preassemble IOCS modules as described in DOS^VS 
5uperyj.sor and 1^0 Macros. Note that separate modules are not assembled for DTFCN or 
DTFSfi, 



The preassembled modules named in this module can be used by any other problem program 
whenever applicable. 

r r r n 



American National Standard COBOL 
American National Standard COBOL and COBOL 
American National Standard COBOL and PL/I 
American National Standard COBOL,, COBOL and PL/I 
COBOL 

COBOL and PL/I 
PL/ 1 

PL/I Optimizing Compiler 
RPG II 

Required IOCS Modules 
L ^ J- J. 

Note: Certain preassembled IOCS modules are required when cataloging IBM components to 
the core image library. Do not delete these modules from the relocatable library until 
after all the IBM components you desire have been cataloged to the core image library. 
The modules are found in "Required IOCS Modules". 



1 Modules 


Blocks 1 


1 223 


1247 1 


1 148 


991 1 


1 163 


1100 1 


1 169 


1181 1 


1 aai 


1272 1 


1 77 


578 1 


1 107 


698 1 


1 70 


412 1 


1 161 


876 1 


1 32 


108 1 
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Relocatable Module Naming Conventions 

Each module name begins with a 3-character prefix and consists of a 5-character field 
corresponding to the option permitted in generation of the module. The following 
3-character prefixes identify the preassembled IOCS modules shipped by IBM: 

IJC I/O Card (CCMOD) and 3881 Optical Mark Reader 

IJD I/O Printer (PRMGD) 

IJF I/O Magnetic Tape (MTMOD) 

IJG Sequential Direct Access (SDMOD) 

IJH Index Sequential Direct Access (ISMOD) 

IJI Direct Access Method (DAMOD) 

IJJ Device Independent Access Method (DIMOD) 

UN I/O Diskette (DUMOD) 

CDMOD 

CDMOD name - IJCabcde 

a = F RECFORM=FIXUNB (always for INPUT and CMBND files) 
= U RECFORM=UNDEF 
= V RECFORM=VARUNB 

b = A CTLCHR=ASA (not specified CMBND) 

= C CONTR0I=YES 

= Y CTLCHR=YES 

= Z neither CTLCHR nor CONTROL is specified 

C = B RDONLY=YES and TYPEFLE=CMBND 

= C TYPEFLE=CMBND 

= H RDONLY=YES and TYPEFIE=INFUT 

= I TYPEFLE=INPUT 

= N RDONLY=YES and TYPEFLE=CUTPUT 

= O TYPEFLE=OUTPUT 

d = B WORKA=YES and I0AREA2=YES 
= I I0AREA2=YES 
= W WORK A = YES 
= Z neither WCRKA nor I0AREA2 is specified 

(for CMBND files: WORKA is no t specified) 

e = DE^ICE=25U0 or DEVICE=3881 

= 1 DEVICE=1442 or DEVICE=2596 

= 2 DEVICE=2520 

= 3 DEVICE=2501 

= U DEVICE=2540 and CRDERR is specified 

= 5 DEVICE=2520 and CRDERR is specified 

= 6 DEVICE=3505 

= 7 DEVICE=3525 and FUNC omitted, FUNC=R or FUNC=P 

= 8 DEVICE=2560 and FUNC omitted, FUNC=R or FUNC=P 

= 9 DEVICE=5425 and FUNC omitted, FUNC=R or FUNC=P 

= A DEVICE=3525 and FUNC=RP 

= B DEVICE=3525 and FUNC=RW 

= C DEVICE=3525 and FONC=PW 

= D DEVICE=3525 and FUNC=I 

= E DEVICE=3525 and FUNC=RPW 

= F DEVICE=2560 and FUNC=RP 

= G DEVICE=2560 and FUNC=RW 

= H DEVICE--=2 5 60 and FUNC=PW 

= I DEVICE-2560 and FUNC=I 

= J DEVICE=2560 and FUNC=RPW 

= K DEVICE=5U25 and FUNC=RP 

= L DEVICE=5425 and FUNC=RW 

= M DEVXCE=5425 and FUNC=PW 

= N DEVICE=5a25 and FUNC=I 

= DEVICE=5it25 and FUNC=RPW 
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r — 

1 CDMOD 
1 Names 


-T- T 
i i 
I 1 
1C0E0L|PL/I 
1 1 


T T T 

1 1 PL/I 1 

1 1 Optimizing 1 American 
]RPGII} Compiler [Standard 

X 1 ' 


1 

National j 
COBOL I 


1 IJCFAOID 


t 

i 
-f- 

1 
-+- 

1 
-f- 

l 

--!- 

1 
-]- 

1 
-i- 

I 
H- 

1 
-+- 

i 

i 

f 




T 

-+- 

-+- 
-+- 
-+- 
-+- 
-i- 
-+- 
-+- 
-+- 

J. 




t 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 
1 




1 

-+- 

--f-- 

-+- 

-+- 

-+- 
_l_ 

-+- 
-l~ 
-+- 

1 


X 


1 1 1 1 1 1 1 1 1 






JIJCFAOIO 














1 IJCFAOIl 


X 


X 




X 


X 




IIJCFA0I2 


X 


X 










} IJCFA0I4 
j IJCFAOX5 


X 
X 


X 


— 


X 
X 


X 
X 




1 IJCFAOI7 


X 






X 






1 IJCFA0I8 


X 






X 






1 IJCFA0I9 








X 






1 IJCFAOZA 


X 






X 






] IJCFAOZC 


1 

1 
_ 1 


X 


T 




\ 
1 




1 
J. 


X 


T 

1 

± 






IIJCFAOZD 


1 
! 

-i- 
i 

i 
-+- 

1 
-f- 

i 
-+- 

1 
-f- 

1 
+- 

1 
-i- 

! 

-+- 

! 
-|_ 

1 
-i- 

1 




T 

-+- 
-+- 
-+■- 
-f- 
-+- 
-+- 
-+- 
-+- 

1 




1 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 

-+- 
i 




1 

-+- 
-+- 

-+- 
-+- 
-+- 
-f- 
-+- 
--1- 
-+- 
-+- 


X 


1 1 1 1 1 1 1 1 1 1 1 






1 IJCFAOZE 


X 






X 






lUCFAOZO 














1 IJCFAOZl 


X 


X 




X 


X 




IIJCFA0Z2 
1 IJCFAOZ4 


X 


X 
X 





X 


X 




IIJCFA0Z5 
1 IJCFAOZ7 


X 
X 


— 





X 
X 


X 




IIJCFA0Z8 


X 






X 






1 IJCFAOZ9 




-+- 
-+- 






X. 






IIJCFCCZO 
i IJCFCCZl 


— 


— 


X 
X 




— 




IIJCFCCZ2 


1 

i 
-+- 

1 
-f- 

1 




T 

-+- 

-+- 

1 . 




1 

-+- 

-+- 
J. 


X 


1 

-+- 
-+- 




T 
— h 






1 IJCFCIWB 
1 I JCFCIWG 


— 


— 


X 
X 




— 




i IJCFCIWL 
IIJCFCIZO 


1 

1 

-f- 

1 
1 


X 


T 

-+- 

1 


— 


1 

-4- 
1 


X 
X 


T 

- + - 

X. 




T 

--+ 

_ 1 


— 




1 IJCFCIZl 


1 
1 

-f- 
i 

+- 
1 

-JL 


X 


T ■ 
-+- 

. t 




1 
-+- 

-+- 

1 


X 


1 

-+- 
-+- 




t 

--+ 

— + 

L 






IIJCFCIZ2 


X 




X 








1 IJCFCIZ6 
L 


X 




X 


X 




J 
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r T T T T T 

I I I i I PL/I I 

I CDMOD I I I I Opt i mi zing I American National 
iNaroes |COEOL|PL/I |RPGII| Compiler [Standard COBOL 
^ 1 1 1 + + 

IIJCFCIZ7 I I I X I I 

^ 1 1 + + + 

IIJCFCIZ8 I I I X I I 

^ + + + ^ 4- 

IIJCFCIZ9 I I I X I 1 

^ 1 + 1 ^ 4. 

IIJCFCOIl j I I X I I 

^ ^ 4. 1 1 -|. 

I iJCFcom I I I X I 1 

^ f 4 ^ 1 + 

IIJCFC0I5 I I I X I I 

^ + + -I- ^ ^ 

I IJCFCOWA I I I X I I 

^ f + 4 + + 

I I JCFCOWC 1 ! I X I I 

^ 4 4 + 4 4 

I IJCFCOWE I I I X I ] 

|. 4 4 4 4 4 

IIJCFCOWF I I I X I I 

^ 4 4 4 4 4 

I IJCFCOWH I I I X I I 

|. 4 4 4 4 4 

I lo 'IFCOWJ I I I X I I 

^ 4 4 4 4 4 

I IJCFCOWK I I I X I I 

^ 4 4 4 4 4 

IIJCFCOWM I I I X I I 

^ 4 4 4 4 4 

1 IJCFCOWO I I I X I I 

^ 4 4 4 4 4 

IIJCFCOZl 1 I I X I I 

^ 4 4 4 4 4 

IIJCFC0Z4 I I I X I I 

IIJCFC0Z5 I j I X I I 

. 4 4 4 4 4 

IJCFC0Z7 I I I X I I 
^ 4 4 4 4 4 

IIJCFCOZ8 I I I X I I 

h + + + + + 

IJCFCOZ9 I 1 I X I I 

lUCFYOID I I I I X I 

4 4 4 4 4 

IJCFYOIO I X j I I I 
^ 4 4 4 4 4 

IIJCFYOIl 1 I X I X I X I 

4 4 4 4 4 

IJCFY0I2 I 1 X I j I 
^ 4 4 4 4 4 

IIJCFY0I4 1 I X I X I X I 

, 4 4 4 4 4 

IJCFY0I5 I I I X I X I 
, 4 4 4 4 4 

:IJCFY0I7 I X I I I X I 

4 4 4 4 4 

IJCFYOI8 I 1 I I X I 

IJCFY0I9 I ] I I X I 
4 4 4 4 4 

IJCFYOZA I I I I X I 
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CDMOD 
Names 
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! 

+- 
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+— - 
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X 

+ 



+— - 
I 

4 

X 



i X I 

X 

X 
X 
X 



IJCFZIIl 
IJCFZII2 



! X 

4— - 

1 X 



X 

+ — 

X 






IJCFZII3 



I X 

•f— - 

-I— - 

I X 



I X 

+ — 

I X 

+ — 

X 



IJCFZII6 
IJCFZII7 









IJCFZII8 
IJCFZII9 
IJCFZIWA 



4— - 
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+ — 



+ — 
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+ — 
I 















IJCFZIWB 
IJCFZIWE 
IJCFZIWF 
IJCFZIWG 
IJCFZIWJ 
IJCFZIWK 
IJCFZIWL 















I X 

-+ 

X 

+— - 

X 

-I— -- 

X 

+- — 

I X 

-+ — 

I X 

-+- 

1 X 


















~+ + 



IJCFZIWO 
IJCFZIZA 
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I 

H- 
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IJCFZIZE 



I X 
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r r T T T T n 

I I I I i PL/I I I 

I CDMOD I I i I Optimizing I AiTterican National] 
j Names ICOEOLIPL/I IRPGIIJ compiler | Standard COBOL | 

IIJCFZIZO i X I X I X I X I X 1 

i. ^. 1 1 ^ + ^ 

IIJCFZIZl I X I X I X j X ] X I 

i. — , + + + ^ ^ ^ 

IIJCFZIZ2 I X 1 X I X I X I X I 

^ 1 1 + 4. + ^ 

IIJCFZIZ3 J X I X 1 X I X 1 X I 

^ 4. + 1 ^ + ^ 

IIJCFZIZ6 I X 1 I X I X I I 

IIJCFZIZ7 i X I I X I X i I 

^ ^ + 1 1 4- -I 

IIJCFZIZ8 I X I I X I X 1 I 

1IJCFZIZ9 ! I I X I X j I 

|. + 4. ^ 4- ^ ^ 

I IJCFZOID 1 X I I I X I I 

IIJCFZOIl I X I X I ! X I X I 

|. 4. 1 ^ ^ + 4 

IIJCFZ0I2 I I X I I I I 

^ ^ 1 ^ + + 4 

IIJCFZOIU I X I X I X 1 X i X I 

y 4 + + 4 + 4 

IIJCFZ0I5 I X I I I X I X 1 

^ 4. ^ 4 4 4. 4 

IIJCFZ0I7 I X I I X I X ] I 

IIJCFZ0I8 I X I I X I X 1 I 

j. 1 1 ^ 4. + 4 

IIJCFZ0I9 I I I X I X I I 

i IJCFZOWA I 1 I X I i t 

^ 4 1 4 1 4. 4 

JIJCFZOWC I I I X I I I 

I IJCFZOWE I I I X I I I 

^ ^ 4. 4. 4. 4. 4 

IIJCFZOWF I I I X I I I 

IIJCFZOWH I ! I X I I I 

^ ^ 4. 4 4. + 4 

IIJCFZOWJ I I I X I 1 I 

, + 4. 4. 4. 4 4 

I IJCFZOWK I I I X I I I 

IIJCFZOWM I I 1 X I 1 I 

I JCFZOWO i I I X I I 1 

^ 4. 4. + ^ + 4 

jIJCFZOZA I X I I I X I I 

IJCFZOZC 1 X I I I X I I 

IIJCFZOZD i X I I I X I I 
+ 4 4. 4. 4. 4 

IJCFZOZE I X I I j X I I 

^ 4. 4. + 4. 4 4 

[IJCFZOZl I X I X 1 I X I X I 
+ + 4 4. 4 4 

IJCFZ0Z2 ! I X I I I 1 
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r T 




-T T- 

1 1 




T 

1 PL/ 1 


T -1 

1 1 


] CDMOD 1 




1 1 




1 Cptimizing 1 American National! 


1 Names 1C0E0L|PL/I IRPGII} Compiler 

L J. ' 1 1 


1 Standard COBOL | 
_+ ^ 

1 ^ 1 


IIJCFZ0Z4 1 


X 


T T 

1 ^ 1 


X 


T 
1 X 


h f- 

1IJCFZ0Z5 j 

L J. 


X 


-+ +- 

J. — 4- 


— — 


-+ 

1 X 
J. 


_^ ^ 

1 ^ 1 
1 i 


r T 

IIJCFZ0Z7 1 

L X 


X 


T t 

i 1 


X 


t 

1 X 


t 1 
J. J 


r T 

IIJCFZ0Z8 1 


X 




X 


T 

1 ^ 


T 1 


1- +- 

IIJCFZ0Z9 1 

L J. 


"~^'~ 


-+ +- 

1 1 


X 


1 ^ 
J. 


-^ 4 

J. _ 1 


r T 
1 IJCUAOIl 1 
h +- 

JIJCUAOIU ] 

^ -h- 

IIJCUA0I5 1 
j. ^- 

IIJCUA0I7 1 




t T 

-i +- 

-+ +- 

-+ -1- 




t 

1 X 
-+ 

1 X 
-+ 

1 X 
-+ 

1 X 


T 1 
1 ^ 1 

1 ^ 1 
_^ ^ 

1 ^ 1 

_^. 4 


X 




X 








Y 1_ 

IIJCUA0I8 1 
j. 4._ 

1 IJCUAOI9 i 


X 


-+ +- 

-+ +- 




-+ 

1 X 

-+ 

1 X 


_+ ^ 

_4. ^ 






L J. 




J. 4. 




4- _ _ 


X A 


r r 
] IJCUAOZA 1 
y ^_ 

1 IJCUAOZC 1 

i f- 

1 IJCUAOZE 1 

1- +- 

1 IJCUAOZl j 




T T 

-+ i- 

-+ +- 




T — - 

1 ^ 
-+ 

1 X 
-+ 

1 X 
-+ 


T 1 

_4. ^ 

_+ 4 

_^. ^ 

1 ^ 1 










X 




L _J- 




1 1 




1 


X J 


r t 

1 IJCUAOZU 1 

1- +- 

IIJCUA0Z5 1 


X 


t T 




T 

i ^ 

1 ^ 


T 1 
1 ^ 1 

_+ 4 

1 ^ 1 


X 




L J. 




1 J. 




J. _ 


X _ J 


r T 

IIJCUA0Z7 1 




T T 




t 

1 X 


T - — -J 


h +- 

IIJCUAOZ8 1 

I- +- 

IIJCUA0Z9 I 


X 




~ 


1 ^ 
1 ^ 


.+ ^ 

-+ ^ 






1- i- 

IIJCUYOIl 1 





-+ +- 





-+ 

1 ^ 


_^. ^ 


j. 1_ 

IIJCUY0I4 1 





-+ +- 





-+ 

1 ^ 


_-{. 4 


IIJCUY0I5 1 

t- f- 

1IJCUY0I7 1 
h +- 

1IJCUYOI8 1 





-+ +- 

-+ +- 

-+ +- 


— 


1 ^ 
-+ 

1 X 
-+ 

1 X 


-+ 4 

_+ -1 

_4. 4 










h +- 

I1JCUY0I9 1 





-+ +- 





-+ 

1 ^ 


_-^ 4 


1- +- 

jIJCUYOZA 1 





-+ +- 





1 ^ 


_4- 4 


h ■}-- 

lUCUYOZC i 

1 IJCUYOZE 1 

V +- 

} IJCUYOZl i 




-+ +- 

-+ +- 

-+ +- 


— 


-+ 

1 X 
-+ 

1 X 
-+ 

1 ^ 


_+ 4 

_+ 4 

-+ -1 










h +- 

1 IJCUY0Z4 1 





-+ +- 





1 X 


_4. 4 
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r T T T T T 1 

! 1111 PL/I ] I 

I CDMOD j I I I Cptiinizing I Airerican National! 
INaines |COEOL|PL/I IRPGIIJ Compiler | Standard COBOL | 

IIJCUY0Z5 I I I I X I I 

^ 1 + 4 4 4 ^ 

IIJCUY0Z7 i I I I X ] I 

[. 4. 4 4 4 4 4 

JIJCUYOZS I I I I X I I 

|. 4 + 4 4 4. -I 

IIJCUY0Z9 ! I I I X I I 

IIJCUZOIl I X I I I X I X I 

|. 4 4 + 4 4 4 

lijcuzom } X I I I X I X I 
^ 4 4 4 4 4 4 

IIJCUZ0I5 I X I I I X I X I 

[.___ 4 1 4. 4. 4 4 

IIJCUZ0I7 ! X 1 I I X I I 

IIJCU20I8 I X I I I X I I 

IIJCUZ0I9 I I I I X I I 

^ + 4 4 4 + 4 

IIJCUZOZA I I 1 I X I I 

^ 4 4. 1 + 1 4 

IIJCUZOZC 1 I ! I X I I 

IJCUZOZE 1 I I I X I I 

^ 4. 4. 4 4. 4. 4 

IIJCUZOZl I X I I I X I X I 

4. 4 4. 4 4. 4 

IJCUZ0Z4 I X I I I X I X I 

^ 4. 4. 4 4. 4. 4 

IJCUZ0Z5 I X I I I X I X I 
+ + + + + -f 

IJCUZ0Z7 I X I I I X I I 

^ 4. 4 4. 4 4. 4 

IJCUZ0Z8 I X I I I X I I 
1 4 4 4 4 4 

IJCUZ0Z9 I I I I X I I 
4 4 4 4 4 4 

IJCVAOIl I X I I I X I X I 
4 4 4 4 4 4 

I JC VAGI 4 I X I 1 I X I X I 

IJCVA0I5 I X I I I X I X I 
4 4 4 4 4 4 

IJCVA0I7 I I I I X I I 

. 4 4 4 4 4 4 

IJCVAOI8 I X I I I X I I 
4 4 4 4 ^4 4 

IJCVA0I9 I I I I X I I 
4 4 4 4 4 4 

IJCVAOZA I I I I X I I 
4 4 4 4 4 4 

IJCVAOZC I I I I X 1 I 
4 4 4 4 4 4 

IJCVAOZE I I I I X I I 
4 4 4 4 4 _ 4 

IJCVAOZl I X I I I X I X I 
4 4 4 4 4 4 

IJCVAOZU ! X I I I X I X I 

4 4 4 4 4 4 

IJCVAOZ5 I X I I I X I X I 
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r T ^T T T T 

I I I I I PL/I I 

I CDMOD I I I I Optirri zing I American National 
i Names JCCEOLIPL/I |RPGII| Compiler | Standard COBOL 

^ ^ + 1 ^- + 

IIJCVA0Z7 I I I I X I 

(. 1 ^ 4 ^ + _^__ 

IIJCVA0Z8 I X I I 1 X I 

^ 4 + 1 + + 

IIJCVA0Z9 i I I I X I 

I IJCVYOIl I I I I X I 

^ 1 1 4 4 4 

IIJCVY0I4 ! I I I X I 

^ 1 4 4 4 4 

IIJCVYOI5 I I I I X I 

^ 1 1 4 4 4 

IIJCVY0I7 ] I I I X ] 

JIJCVYOIS I I I I X I 

|. 4 1 4 4 4 

IIJCVY0I9 1 I I I X i 

, 4. 1 4 4 4 

I IJCVYOZA I I I I X I 

^ 4 1 4 4 4 

IIJCVYOZC ! I I I X j 

, 4 4 1 4 4 

I IJCVYOZE I I I I X 1 

^ 4 4 4 4 4 

IIJCVYOZl ] I 1 I X i 

. 4 4 4 4 4 

IJCVY0Z4 I I I I X I 
^ 4 4 1 + 4 

IIJCVY0Z5 I I I I X I 

IJCVY0Z7 I I I I X I 
^ 4 1 4 4 4 

IIJCVY0Z8 I I I I X I 

4 4 4 4 4 

IJCVY0Z9 I I I I X I 
, 4 4 4 4 4 

IJCVZOIl i X I I I X I X 
4 4 4 4 4 

IJCVZOIU I X I I I X I X 
4 4 4 4 4 

IJCVZ0I5 I X I I I X I X 
4 4 4 4 4 

IJCVZOI7 I X 1 I I X I 
4 4 4 4 4 

IJCVZ0I8 ] X I I I X I 
4 4 4 4 4 

IJCVZOI9 I I I I X I 

IJCVZOZA I I I I X I 
4 4 4 4 4 

IJCVZOZC ! I I I X I 

IJCVZOZE I I I I X I 
L ± J. X X 
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r T T T T T 1 

I I I I I PL/I ! i 

I CDMOD I I I I Cptimizing I AiTierican National] 
i Names | COBOL | PL/I ]RPGIII Compiler | Standard COBOL | 
|. 4 ^ 4- ^ 4- ^ 

I IJCVZOZl I X I I I X I X I 

IIJCVZOZ4 I X I I I X I X I 

^ ^ ^ ^ ^ + ^ 

I IJCVZOZ5 I X I I I X I X I 

|. ^ + ^ + + ^ 

IIJCVZ0Z7 I X I I I X I I 

^ + + ^. 1 + ^ 

IIJCVZOZ8 I X I I I X I I 

^ 1 ^ + + + ^ 

IIJCVZ0Z9 I I I I X I I 

L L ± i X -L i 
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DAMOD 



DAMOD name = IJIabcde 



a 


= 


B 




= 


F 




= 


S 




- 


V 


b 


_ 


A 




= 


W 




= 


z 


c 


= 


E 




= 


I 




= 


R 




= 


Z 


d 


= 


H 




= 


P 




= 


R 




= 


Z 


e 


= 


H 




= 


X 




= 


Y 




= 


Z 



RECFORM=UNDEF (handles both UNDEF and FIXUNB) 

RECFORM=FIXUNB 

RECFORM=SPNUNB 

RECFCRM=VARUNB 



AFTER=YES 

RPS version of module 

AFTER is not specified 

IDLOC=YES and FEOVD=YES 

IDLOC=YES 

FEOVD=YES 

neither is specified 

ERREXT=YES and RELTRK=^YES 

ERREXT=YES 

RELTRK=YES 

neither is specified 

HOLD=YES and RDONLY=YES 

HOLD=YES 

RDONLY=YES 

neither is specified 



r 

1 


7 




1 

1 




■ 1 




I 
1 


FL/I 


T 


1 
1 


1 DAMOD 






! 








lOptiinizi 


ng| American l^ational | 


1 Names 


1 COBOL] PL/I 


|RPGII| 


Compile 


r Istanda 


rd COBOL 1 


L 


1 




1 




1 




1 




J. 


4 


r 


1 




T 




1 




1 






1 


1 IJIEAIRZ 
\ 


-+- 


X 


-+- 





-+- 





-\- 




__| 


X 1 


IIJIBAIZZ 
1- 


-f- 


X 


-+- 


^ 


-+- 





-\- 




— + 


X 1 


IIJIBAZHZ 
1 


-+- 




-+- 




-+- 




-\- 


X 


— + 




1 IJIBAZRZ 


X 








X 1 


L 


_ 1 




J. 




-l- 




J 




J. 




r 


1 




T 




1 




1 




T 




IIJIEAZZZ 

L 


1 


X 


1 




J. 




4 




I. 


X 1 


r 


■T~ 




T 




T 




1 




T 




1 IJIBWEHW 
1- 


-\- 





-+- 





-+- 





-+- 




— + 


j 


lUIBZIRZ 
L 


1 


X 


1 




1 




J. 




J. 


X 1 


r 


J 




T 




T 




T 




T 




IIJIBZIZZ 
L 


-J. 


X 






1 




i. 




J. 


X 1 


r 


1 






t 




1 




1 




T 




IIJIBZZHZ 
1- 


-+- 





-+- 





-+- 





-+- 


X 


—■ h 




IIJIBZZRZ 
j. 


-k- 


X 


-■h- 





-+- 


_— . 


-+- 




— + 


X 1 


IIJIBZZZZ 

L 


\ 


X 


1 




J. 


X 


-I— 




L 


X 1 


r 


1 




T 




1 




1 




T 




! IJIFAIRZ 


-+- 


X 


-■1- 




-+- 




-+- 




-1 


X 1 


r 

JIJIFAIZZ 

L 


X 








X [ 


\ 

1 IJIFAZHZ 








X 




\ 


-f- 





-+- 





-+- 





-+- 




^ 




IIJIFAZRZ 


.J. 


X 


J 




J 




_l 




X. 


X 1 


r 


1 




T 




1 




1 




^ 




1 IJIFAZZZ 




X 




X 












X 1 
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r T r r r r 1 

I till PL/I I i 

j DAMOD I i I I Optimizing I American National! 
I Names | COBOL] PL/I |RPGII| Compiler (Standard COBOL | 

I IJIFWEHW 1 I I I I I 

|. + 4 ^ ^ ^ ^ 

IIJIFZIRZ I X I I 1 I X I 

|. 1 ^ 4. 4- + ^ 

IIJIFZIZZ I X I ] j I X I 

y 1 1 1 ^ 1 4 

I IJIFZZHZ I I I I X 1 I 

^ ^ + + + + 4 

JIJIFZZRZ I X I I j ! X I 

jlJIFZZZZ I X I X I X I I X I 

|. ^ ^ ^ 4- 4- 4 

lUISAIRZ I X I I I I X I 

[IJISAIZZ I X t I I I X I 

lUISAZRZ ] X I I I I X I 

^ ^ ^ ^ ^ 1 ^ 

IIJISAZZZ I X I I I I X I 

j. 1 + + ^ 1 ^ 

IIJISWEHW I I I I I I 

^ + + + ^ ^ ^ 

IIJISZIRZ I X I I I I X I 

[. ^ ^ 4- + + 4 

IIJISZIZZ I X I I I I X I 

IIJISZZRZ I X I I I i X I 

IIJISZZZZ i X I I I 1 X I 

I IJIVWEHW I I I I I I 



L J J. J. X -L J 
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Page of GC33-5377-6, Revised November 28, 1977, By TNL GN33-9230 



DIMOD 

DIMOD name = IJJabcde 

Note ; See "Required IOCS Modules" before deleting modules with the IJJ prefix, 

a = F RECFORM=FIXUNB 

b = C non-RPS version of module 

= V RPS data set 

c = B TYPEFLE=OUTPUT (processes both input and output) 

= I TYPEFLE=INPUT 

d = I I0AREA2=YES 

= Z I0AREA2 is not specified 

e = C RDONLY^YES 

- D RDONLY is not specified 



I DIMOD Names 

I 

IIJJFCBID* 

JIJJFCBZD* 

IIJJFCIID 

I IJJFCIZD 

1 1 JJFVBIC * 

I IJJFVIIC 

t 



-T ^" 



PL/I 



fiPG II 



PL /I 
Optimizing 
Compiler 



-4 



♦Note: To obtain support for the TRC parameter for the 3800 printer when 
extended printer buffering is not being used, reassemble the modules that 
include B in the module name (that is, those for which TYPEFLE^OUTPUT has been 
specified) . Specify TRC^^YES on the DIMOD macro when reassembling. 
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ISMOD 



ISMOD name = IJHabcde 



= A RECFORM^BOTH and IOROUT=ADD Or ADDRTR 

= B RECFORiyi=FIXBLK and lOROUT^ADD or ADDRTR 

= U RECFOR]y!=FlXUNB and IORCUT=ADD or ADDRTR 

= Z RECFORM is not specified and IOROUT=LOAD or RETRVE 



b = A IOROUT=ADERTR (non-RPS version of module) 

= I IOROUT=ADD 

= L IOROUT=LOAD (non-RPS version of module) 

= R IOROUT=RETRVE 

= V IOROUT=ADDRTR ( RPS version of module) 

= X IOROUT=LOAD (RPS version of module) 

C = B TYPEFLE=RANSEg 

= G I0AREA2=YES and TYPEFLE^SEQNTL or IOROUT=LOAD 

= R TYPEFLE=RANDOM 

= S TYPEFLE=SEQNTL 

= Z neither is specified and IOROUT=LOAD or ADD 

d = B CORINDX=YES and HOLD=YES 

= C CORINDX=YES 

= O HOLD=YES 

= Z neither specified 

e = F CORDATA=YES, ERREXT=YES, and RCONLY=YES 

= G CORDATA=YES and ERREXT=YES 

= O CORDATA=YES and RDONLY=YES 

= P CORDATA=YES 

= S ERREXT=YES and RDONLY=YES 

= T ERREXT=YES 

= Y RDONLY=YES 

= Z nothing is specified 



r r T T T T 1 

I I I I I PL/I I I 

I ISMOD I ] j I Optimizing 1 American National j 
[Names | COBOL | PL/I |RPGII] Compiler ] Standard COBOL | 
|. + 4- ^ ^ 1 ^ 

I IJHAABCP I I I I I X I 

lUHAABCZ I I I X I I X I 

I IJHAABZP I I I I I X I 

^ ^ + + + + ^ 

jIJHAABZZ I X I i X I 1 I 

^ 4- + -I- ^ ^ ^ 

1 IJHAARCG I I I I X I I 

ilJHAARCP I X I X I 1 I X I 

I IJHAARCT I I 1 I X I I 

y ^ + + -j. + 4 

I IJHAARCZ I X I X 1 X I I X 1 

^ + 4 ^ ^ + ^ 

I IJHAARZG I 1 I I X I I 

|. ^ + + + -I- 4 

JIJHAARZP j X i X I 1 I X I 

IIJHAARZT I I I I X I I 

i. ^ ^. -I- + + ^ 

IIJHAARZZ I X I X I X I ! X I 



L X ± X X X J 
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r r T T T T -\ 

I ] I I I PL/I I I 

|ISMOD ] I I j Optimizing! American National] 
I Names |COEOL|PL/I ]RPGII| Compiler | Standard COBOL | 

IIJHAASZZ I X I I I X I I 

j. 1 1 + + + ^ 

IIJHAIZCZ I I 1 X I 1 I 

IIJHAIZZZ I X I I X I 1 I 

|. ^ 1 4 + 1 ^ 

JIJHAVBBF 1 i j I ] I 

^ ^ ^ + ^ ^ ^ 

I IJHAVBBS I I I I I I 

^ ^ ^ 4- + ^ ^ 

lUHAVBCF i -] I I I I 

I IJHAVBCS I I I I 1 I 

^ ^ 1 + + 4- 4 

IIJHAVGBF I ] I I I I 

IJHAVGBS I I I I I I 

1 IJHAVGCF I I I I I I 

IJHAVGCS I I I I 1 I 

IIJHEABCP 1 X I I I I X I 

IJHBABCZ I X I I X I I X I 

^ ^ 1 1 + 4- 4 

IIJHEABZP 1 X I I ) I X I 

IJHBABZZ I X I I X I I X I 

^ ^ + ^ 1 + 4 

IJHEARCP ] X I X I I I X I 

IJHBARCZ I X I X I X j I X I 
, ^ 1 ^ + + 4 

IJHEARZP 1 X I X I 1 I X • 

IJHBARZZ I X I X I X I I X 

r f + + + + 1 

IJHEASZZ I X I I X I I I 

IJBIZCZ I I I X I I i 

, ^ 1 + + 1 4 

IJHBIZZZ 1 X I j X I I I 

IJHUABCP I X I I I I X I 

r -1- + + + + -f 

IJHUABCZ I X I I X I i X I 
4 + 4- 1 4 4 

IJHUABZP I X I I I I X I 

IJHUABZZ I X I I X I ! X I 
+ 1 ^ ^ + 4 

IJHUARCP I X I X 1 ] I X t 
f + + + + -I 

IJHUARCZ I X I X I X 1 I X I 
+ + + + + -I 

IJHUARZP I X I X I 1 I X I 
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r T T T-" T T 1 

I I I I I PL/I I I 

1 ISMOD I } I I Optimizing I American National) 
] Names |COBOL|PL/I |RPGII| Compiler |Standard COBOL | 

jIJHUARZZ I X I X I X I I X I 

^ 4 + 4- ^ ^ ^ 

JIJHUASZZ I X I ] X I 1 I 

IIJHUIZCZ I I I X I I I 

jIJHUIZZZ I X I I X I I I 

1. ^. + + + + 4 

jIJHZLGZT I I I I X I I 

^ -|. 4 + + + ^ 

I IJHZLGZZ I X I I X I I I 

y ^ + 4 + + ^ 

JIJHZLZZT 1 I I I X I 1 

I IJHZLZZZ I X I X I K j I X I 

i IJHZRBCZ 1 X I I X I I X I 

^ + 1 + 1 ^ ^ 

IIJHZRBZZ I X I I X I I X I 

1 IJHZRGZT t I I I X I I 

lUHZRGZZ 1 X I I 5C I I I 

1- 4 1 + + ^ 4 

j IJHZRRCT I I I I X I I 

y 1 4 ^ 1 ^ 4 

jIJHZRRCZ I X I X I X I I X I 

|. ^ ^ + + 1 4 

IIJHZRRZT I I I I X I I 

y + 4 4 4 -I- 4 

I IJHZRRZZ I X I X I X I X I X I 

j IJHZRSZT 1 I I I X I I 

|. 4 4 1 4 4 1 

IIJHZRSZZ |x|x|x| X I x I 

|. 4 4 4 4 4 4 

lUHZXGZS till I I 

L L J. X i i i 
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MTMOD 



MTMOD name = iJFabcde 



a = F RECFORiy!=FIXUNB or FIXBLK 

= S RECFORM=SPNUNB or SPNBLK 

= U RECFORiyi=UISlDEF 

= V RECFORM=VARUNB Or VARBLK 

= N RECFORM=UNDEF and ASCII=YES 

= R RECFORM=VARUNB Or VARBLK, and ASCII=YES 

= X RECFORM=FIXUNB or FIXBLK, and ASCII=YES 

b = B READ=BACK 

= Z READ=FORWARD, or READ is not specified 

c = C CKPTREC=YES 

= Z CKPTREC is not specified 

d = W WORKA=YES is specified 

= Z WORKA is not specified 

e = M ERREXT=YES and RDONLY=YES 

= N ERREXT=YES 

= Y RDONLY=YES 

= Z neither is specified 



MTMOD 
Names 



COBOL 



PL/I 



RPGII 



T T 

PL/I 
Optimizing 
Compiler 



American National 
Standard COBOL 



IJFFBCZN 



h 

K 

IJFFZCZZ 

IJFFZZZN 
I- 



IJFFBCZZ 
IJFFBZZN 



IJFFBZZZ 



IJFFZCZN 






IJFFZZZZ 

!-: 

h- 

IJFRZZWN 

IJFRZZWZ 

\- 

IJFRZZZN 

IJFRZZZZ 
j. 

IJFSZCWN 
IJFSZCWZ 



IJFNBZZN 



IJFNZZZN 












IJFSZZWN 
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r T T T T T 

I I I I i PL/I I 

|MTMOD I I I I Cptiinizing I Aitierican National 
I Names | COBOL | PL/ 1 IRPGII] Compiler | Standard COBOL 
^ ^ + 1 ^ + 

lUFSZZWZ 1 I I X I I 

i. ^ ^. + + + 

JIJFUBCZN I I I I X I 

IIJFUBCZZ I X I I I I 

|. ^ ^. -j. + + 

IIJFUBZZN 1 I I I X 1 

^ ^ 4——+ -h + 

IIJFUBZZZ I I X I 1 1 

lUFUZCZN i 1 I I X I 

1 IJFUZZZN I X i I I X I X 

IIJFUZZZZ 1 X I X I ) I X 

L + + + ^ ^. 

IJFVBCWZ 1 X j I I I 
^ ^ ^ + ^ ^ 

jIJFVBCZZ I X I I I I 

IJFVZCWN I I I X I I 

IIJFVZCWZ I I I X I I 

1 + ^- ^. ^ 

IJFVZCZN I 1 I I X I 

IIJFVZZWZ I I I X I I 

IJFVZZZN I X I I I X I X 
^ ^ 1 + + ^. 

IJFVZZZZ I X I X I ] I X 

IJFWEZZN I I I I X I 
^ ^ 4 + ^ 

IJFXBZZN /I I I I X I 
.^ 4. + ^ + 

IJFXZZZN I I I X I X I 
f 1 ^ + ^ 

IJFXZZZZ I I I X I ! 
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Name list for work file type modules (TYPEFLE=WORK) : 

MTMOD name = IJFabcde 

a = W always 

b = E ERROPT=YES 

= Z ERROPT is not specified 

c = N •NOTEPNT=YES 
= S NOTEPNT=POINTS 
= Z NOTEPNT is not specified 

d = Z always 

e = M ERREXT=yES and RDONLY=YES 

= N ERREXT=YES 

= Y RDONLY=YES 

~ Z neither is specified 

S ystem I/O Modules 



IJFWEZZZ 
IJFWZNZZ 
IJFWZZZZ 



Note : See "Required IOCS Modules" before deleting modules with the IJF prefix. 
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Page of GC33-5377-6, Revised November 28, 1977, By TNL GN33-9230 
PRMOD 

PRMOD name = iJDabcde 

a = F RECFORM=FIXONB 

- V RECFORM=VARONB 
= U RECFORM=UNDEF 

b = h CrLCHR=ASA 

= Y CrLCHR=YES 

= C CONTROL=YES 

= S SrLIST=YES 

= Z neither CTLCHR nor CONTROL nor STLISI is specified 

= U DEVICE=2560 

= V DEVICE=5425 

= T DEVICE=3525 with 2-line printer, and FUNC-XXr 

c = B ERROPr=yES {ERROPr=name in DIFPR) and PRINr0V=YES 

= P PRINTOV=YES, DEVICE is not a 3525, and ERROPT is not specified (EKROPr=RErRif or 

omitted in DPFPR) 

= I PRINTOV=YES, DEVICE=3525, and FUNC=WT or omitted 

= F PRINTOV=YES, DEVICE=3525, and FUNC=R»r 

= C PRINTOV=yES, DEVICE=3525, and FUNC=PiJr 

= D PRINTOV=YES, DEVICE-3525, and FUNC=RPWr 

= Z neither ERROPT (ERROPT^RETRY or omitted in DTFPR) nor PRINTOV is specified, and 

DEVICE is not a 3525 

= O PRINTOV=YES is not specified, DEVICE=3525 and FUNC=MT or omitted 

= R PRINTOV=YES is not Specified, DEV1CE=3525 and FUNC=RWT 

= S PRINTOV=YES is not specified, DEV1CE=3525 and FUNC=PWT 

= T PRINTOV=YES is not specified, DEViCE=3525 and FUNC=RPWr 

- E ERROPr=YES (ERROpf=name in DTFPR) and PRINTOV=yES is not specified 
= U DEVICE=2560 Or 5425 and FUNC=W Or omitted 

= V DEVICE=2560 or 5tl25 and FUNC=R>I 

= W DEVICE=2560 or 5U25 and FUNC=PW 

= X DEVICE-2560 or 5<»25 and FUNC=RP« 

d = I I0AREA2=YES 

^ Z I0AREA2 is not specified 

e = V RDONLY=YES and WORKA*YES 

= W iJORKA=YES 

= Y RDONLY=YES 

= Z neither is specified 

Note ; To obtain support for the TRC parcuneter for the 3800 printer when extended 
printer buffering is not being used, reassemble the required logic modules with 
TRC=YES specified. 
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r T T T T T 1 

I till PL/I I I 

I PRMOD j I 1 I OptiTiiziagI CLnierican National! 
I Names JCOBOLIPL/I j RPGII | Compiler | Standard COBOL | 
|, 1 ^ 1 1 ^ ^ ^ 

IIJDFAOIZ I X I 1 I X I I 

|. 1 1 ^ ^ ^ 4 

IIJDFOlOZZ 1 X 1 I I >c I I 

|. 1 1 1 1 4. ^ 

IIJDFAPIZ i X I I I I X I 

^ 1 ^ ^. ^ 1 ^ 

|IJDF?VPZZ I X I I I I X I 

j. 1 ^ 1 1 ^ ^ 

lUDFARIZ I X I I I X 1 I 

h + + 1 + + ^ 

|IJDF?VRZZ I X I 1 I X I I 

^ + 1 1 1 ^ ^ 

IIJDFA.SIZ I X I I 1 X I I 

|. 1 + 1 1 ^ ^ 

lUDF^SZZ I X I I I X I I 

|. ^ 1 ^ + ^ ^ 

lUDFAIIZ I X I I I X I I 

j. ^ 1 1 ^ 1 ^ 

IIJDFMZZ I X I I I X I I 

|. 1 1 4. ^ 1 ^ 

IIJDFAZIZ I I X I I X ] I 

j. + ^ 1 1 ^. ^ 

IIJDFAZZZ I I X I I X I I 

f + + + + + -I 

IIJDFPOIZ I I I I X 1 I 

J. + 1 ^ 1 ^ ^ 

IIJDFrOZZ I I 1 I X I I 

IIJDFIRIZ I I I I X I I 

I- + + + + f ■} 

IIJDFTRZZ I i I I X I I 

IIJDFrSIZ I I I 1 X I I 

^ 1 + 4. ^ ^ ^ 

lUDFrszz I I I I X I I 

^ ^ 1 1 + 1 ^ 

jijDFrnz I I I I X I I 

^ 1 1 ^ 1 1 ^ 

liJDFrrzz I i I I X I I 

i. -^ ^ 1 ^ ^ ^ 

lUDFjaiZ I X I I I X I I 

I- + + + + + -I 

IIJDFUUZW I I I X I I I 

h f f + + + -I 

lUDFUUZZ I X I I 1 X I I 

^ + 4. 1 ^ ^ 4 

|IJDFU\/Zrt I I I X I I I 

|. 1 ^ 1 4. 1 4 

lUDFav^ZW I I I X I I I 

I- + + -l- -I- + 4 

IIJDFUXZW I I I X I I I 

h f + + + f 4 

|IJDF7[JIZ I I I I X I I 

I- + + + f f i 

I IJDFVCJZW 1 I I X I I I 

I- + -I- + + + -I 

|IJDF\7aZZ I I I ! X I I 

|. + + — ...^ 1 1 4 

IIJDFVVZW I I I X I I I 

L X a. X X X J 
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r T T T T T 1 

I I I I I P^^^ I I 

I PRMOD I I I I Optimizing I American National! 
I Names | COBOL) PL/I |RPGII| Compiler | standard COBOL j 
h + + f 1 1 ^ 

JIJDFVWZW I I I X I I I 

^ 1 4. + + + ^ 

|IJDFVXZ;j I I I X I I 1 

i. 1 1 ^ 1 ^ ^ 

IIJDFYOIZ I I I I X I I 

Y ^ ^ + + 1 ^ 

jUDFYOZi^ I I I X I I I 

^ __4 + + 1 1 ^ 

jUDFYOZZ 1 I I 1 X I I 

^ 1 4. 1 1 -^ 4 

IIJDFYPZH 11)11 I 

lUDFYRIZ I 1 I I K I I 

j. 1 1 4. ^ 1 ^ 

IIJDFYRZW I I I X I I I 

^ 1 ^ 1 4. 1 ^ 

IIJDFYRZZ I I I I X I I 

|. 1 ^ 1 1 1 ^ 

JIJDFYSIZ I I I I X j I 

I- +— — I- + + + ^ 

jUDFYSZiJ I j I X 1 I j 

|. + 1 1 ^ _ ^ ^ 

JIJDFYSZZ t I ) I X i I 

|. + + + + 1 ^ 

jUDFYriZ I ) I I X I I 

IIJDFYrZM ! I I X I I 1 

|. 1 ^ 1 1 1 ^ 

jIJDFYrZZ I i ] I X ) I 

I. + ^ 1 ^ 1 ^ 

IIJDFYPIZ I 1 I I I X I 

^ 4. 1 + + + ^ 

IIJDFYPZZ I X j I I I X I 
1- 1 + + 4. ^ ^ 

[IJDFYZIZ i I X j I X I I 

|._„ ^ 1 ^ 1 1 ^ 

IIJDFYZZZ I I X ) I X I I 

I- +- — + + + f ^ 

JIJDFZOIZ j X 1 I I X I I 

^ ^ 4. 1 1 4. ^ 

IIJDFZOZZ ! 3C 1 I I X I I 

j. + + + 1 ^- ^ 

[IJDFZPIZ I X ) X ) 1 I X I 
|. ^ 1 1 1 1 ^ 

jIJDFZPZZ I X 1 X ) I I X I 
y 1 ^ 1 1 1 ^ 

JIJDFZRIZ I X I I I X I I 

^ + 4. 1 4. ^ 4 

IIJDFZRZZ ) X ) I I X I I 

|. + 1 1 1 ^ ^ 

JIJDFZSIZ I X ) i I X I I 

|. f f 4. 1 ^ ^ 

JIJDFZSZZ 1 X I i I X j I 

j. 1 + 1 ^ 4. ^ 

jIJDFZriZ j X I I I X i I 

f + f + + ■)- ^ 

IIJDFZrZZ j 3C I ) I X I I 

^ + + 1 ^ 1 4 

IIJDFZZIZ I I I i X i I 

^ 4. _4. 1 1 ^ ^ 

IIJDFZZZZ ! i I I X I I 

L X X X X X J 
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r T T T T T 

I I I I I PL/I I 

I PRMOD I I I j Optitiizingj American National 
I Names |COBOL|PL/I | RPGII | Compiler | standard COBOL 
|. 1 1 1 + ^ 

IIJDQAOIZ I X I I \ K I 

I- + + + f -1- 

IIJDUA.OZZ I X i I I X I 

i + ■)- + + + 

IIJDUAPIZ I X I I I I X 

V + + + -l- -I- 

IIJDUPlPZZ I X I I I I X 

h + + + + + 

IIJDUARIZ I X I I I X I 

|. 1 + + ^ 1 

IIJDUARZZ I X I I I X I 

^ 1 1 1 1 1 

IIJDUASIZ I X I I I X I 

h +— — + + -h + 

IIJDUASZZ I X I I I X I 

1- + + + + -I- 

IIJDUAriZ I X I I I X I 

^ + 1 ^ ^ 1 

liJDUArzz I X I I I X I 

f -}- -I- + 1 + 

IIJDUAZIZ I I I I X I 

^ + 1 ^ ^ 1 

jIJDUAZZZ I I I I X I 

^ ^ ^ 1 1 ^ 

lUDuroiz I I I I X I 

^ 1 1 ^ ^. ^ . 

liJDurozz t I I I X I 

I- + + + + + 

jIJDUrRIZ I I i I X I 

j. 1 1 1 f 1 

IIJDUrRZZ I I I I X I 

^ + f 1 1 ^ 

liJDursiz I I I I X I 

I- + + + + f 

lUDUTSZZ I I I I X I 

I- + + + + + 

liJDumz I I I I X I 

h + + -I- + — + 

liJDurrzz I i I I X I 

I- + -I- + + + 

lUDUUUIZ I X I I I X I 

^ 1 + ^ ^. ^ 

liJDuaazz I X I | I x | 

|. 1 4. 1 1 ^ 

\IJDUVUIZ I I I I X I 

J. 4 ^ 1 1 ^ 

IIJDUVUZZ I I I I X I 
|IJDU!i:OIZ I I I I X I 

j. 4. ^ ^ ^ ^ 

IIJDUYOZZ I I I I X 1 

I- + + + + -I- 

liJDuypiz I X I I I 1 X 

j. ^ 1 1 1 1 

IIJDUYPZZ I X I I I I X 

I- -I- f + + + — 

IIJDU^RIZ I I I I X I 

h + + + -I- + 

IIJDUYRZZ I I I I X I 

h + + + + + 

IIJDUYSIZ I ) I I X I 

L J. ± X X X 
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r T T T T T 1 

i i I I I PI^/I i i 

I PRMOD I I I i Optiiiizing I American National! 
I Names JCOBOLIPL/I |RPGII| Compiler | Standarca COBOL | 
^ 1 1 ^. 1 1 ^ 

JIJDUYSZZ 1 I I I X I I 

i. 1 ^. ^ 1 1 4 

|IJDU5friZ I I I I K I I 

y _+ + ^. 1 ^. 4 

IIJDUYrZZ I I I I K I I 

^__ 1 ^. + 1 1 4 

lUDUYZIZ I I I I K I I 

i. + 1 ^ ^. ^ 4 

IIJDUYZZZ I I I j X I I 

I- -h -I- + + f ■} 

IIJDUZOIZ I X I I I X 1 I 

|. 1 ^ 1 1 4. 4 

IIJDUZDZZ I X I I I X I I 

^ 1 1 1 + 1 4 

IIJDUZPIZ I X I I I I X I 

|. + + 4- 1 ^ 4 

IIJDUZPZZ I X I I I I X I 

j. 1 4- 1 1 1 4 

JIJDUZRIZ I X i I I X I I 

|. + 1 1 4- 4- 4 

IIJDUZRZZ I X I I I X I I 

f + -j- + + f i 

IIJDUZSIZ 1 X I I I X I I 

I- 1 ^ ^ 1 1 4 

JIJDUZSZZ ! X I I I X I I 

|. ^ 1 4- 1 1 4 

jijDuzriz I X I I I X 1 I 

I- + + + + -I- ^-f 

liJDUzrzz 1 X I I I X I I 

^ ^ ^ 1 + ^ 4 

lUDUZZIZ I I ) I X I I 

j. 1 + 4- ^ ^ 4 

jIJDUZZZZ I I I I X I I 

^ ^ 1 1 1 1 4 

IIJDV^OIZ I X I I I X I I 

l. ^ ^ 4. 1 1 4 

ilJDVft.OZZ I X I I I X I I 

h + f + + + -I 

IIJDVAPIZ I X I I I I X I 

^ + + 4- 4. 4. 4 

|IJDV?VPZZ I X I I I I X I 

|. 4- 4. 4- 4. 4. 4 

IIJDVARIZ I X I I I X I I 

[ +— + -I- -I- + -I 

IIJDV?VRZZ 1 X I I I X I I 

|. 4- 4. 1 1 + 4 

JUDVASIZ I X 1 I I X I I 

|. 4. 4. 4. 4. 4. 4 

IIJDVASZZ I X I I I X I I 

h + 4- + + + -I 

liJDVAriz I X I I I X I I 

^ + 4. 4. 4. 4. 4 

|iJDV?^rzz I X I I 1 X I I 

h f f + + i -I 

IIJDVAZIZ I I I I X I I 

y + 1 4. 1 4. 4 

IIJDVAZZZ I 1 I I X I I 

|. 4. 4. 4. 4. 4. 4 

liJDvroiz I I I I X I I 

t X X X X X J 
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r T T T T T 1 

I i I I I PL/I 1 I 

jPRMOO I I 1 I Optitiizing I American National! 
1 Wames |COBOL|PL/I | RPGII | Compiler | Standard COBOL | 

[ + + + + + ^ 

lijDvrozz 1 I I I X I I 

^ 1 + 1 1 ^ ^ 

IIJDVrRIZ I 1 1 1 X t I 

j. 1 1 ^ 1 4. 4 

IIJDVrRZZ I I I I >c I I 

I- — + + + + -I- ^ 

lijDvrsiz I I I I X 1 I 

|. ^ 1 1 1 ^ 4 

liJDvrszz I 1 I I X I I 

|. 1 ^ 1 ^ 1 4 

liJDvrriz I I I I X I I 

j. 1 ^ 1 1 1 4 

jijDvrrzz I I I I X I I 

I- + + + f + ^ 

liJDvauiz I I I I X I I 

I- + + + + + ^ 

jijDVjazz I X I I I K I i 

h + + + -I- f ^ 

(IJDVVUIZ I X j I I X I I 

^ + ^ 1 1 1 4 

[UDWUZZ I I I I X I I 

|. + 1 1 ^ 1 4 

JIJDVYOIZ I I I i X 1 I 

[ + + + ■}■ -I- ^ 

|IJDV!fOZZ I I I I X I I 

j. 1 ^ 1 1 1 4 

IIJDVYPIZ 1 X 1 I I I X I 

|. 1 1 ^ 1 1 4 

jIJDV^PZZ I X j j I I X I 

I- + + + 1 1 ^ 

IIJDVYRIZ i I I I X I I 

h + -j- + 1 -I- -I 

IIJDViTRZZ I I I I X I 1 

^ 1 + 1 4- 1 4 

liJDvysiz I I I I X I I 

|. 1 + 1 + 1 4 

JIJDVZSZZ I I I I X I I 

lUDVYIIZ I I I I X I I 

j. ^ 1 1 1 1 4 

lUDVYTZZ I I I I X I I 

I- + + + + -f- ^ 

IIJDVYZIZ I I I I X I I 

|. + 1 ^ 1 ^ 4 

liJDVirzzz I I I I X I I 

h + + + + + ^ 

IIJDVZOIZ I X I I I X I I 

^ ^ ^ ^ 1 1 4 

JIJDVZOZZ I X 1 j I X I I 

^ + 1 ^. ^ 1 4 

lUDVZPIZ I X I I I I X I 

h + f + + + ^ 

IIJDVZPZZ I X I I I I X I 

|. 1 ^ 1 ^ 1 4 

IIJDVZRIZ I X I t I X I I 

h + + + + + ^ 

lUDVZRZZ I X t I I X I I 

y ^ 1 ^ Y f ^ 

IIJDVZSIZ I X I I I X I I 
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T T T T T 1 

I I I I Pt./I I 

PRMOD I i I I OptLtiizing I American I'lational 
Names j COBOL j PL/I iRPGIlj Compiler | Standard COBOL 



I- 

IIJDVZSZZ I X I 
|. ^ 4.. 

jiJDVznz i X 1 

Y + +- 

liJDvzrzz I X I 
^ 1 1. 

IIJDVZZIZ 1 I 
Y + 1. 

IIJDVZZZZ I I 
L i J.. 



SDMOD 



SOMODxx name = IJGabcde 

a = C RECFORM=FIXUNB or FIXBLK and HOLD=YES 

- F RECFORM=FIXUNB or FiXBLK and HOLD is not specified 

= P RECFORM=SPtJaNB or SPNBLK and HDLD^YES 

= Q RECFORM=SPNUNB or SPNBLK and HOLD is not specified 

= R RECFORM^UNDEF and HOLD=YES 

= S RECFOR«=VARUNB or VARBLK and riOLD=YES 

= U RECFORM=UNDEF and HOLD is not specified 

= V RECFORM=VARUNB or VARBLK and HOLD is not specified 

b = I SDMODxI (non-RPS version of nodule) 

= SDHODxO (non-RPS version of module) 

= SDMODxU (non-RPS version of module) 

= W SDMODxI (RPS input data set ) 

= X SDMODxO (RPS output data set) 

= Y SDMODxU (RPS Update data set) 

c = C ERROPr«YES and ERREXr=YES 

= E ERROPr=YES 

= Z neither is specified 

d = M TRUNCSs^YES and FEOVD=YES 

= r rRONCS=YES 

= W PEOVD=YES 

= Z neither is specified 

e = B CONTROL=YES and RDONLY-YES 

= C CONTROL=YES 

= Y RDONLY=YES 

= Z neither is specified 
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r T T T T T •- ""I 

I I I I i PL/I I I 

] SDMOD I I I I Optimizing I American National! 
I Names | COBOL | PL/I |RPGII| Compiler (standard COBOL | 
|. + + 1 1 ^ ^ 

jijscYcyiB ill! I I 

h f + + + f ^ 

IIJGCZC^B lilt I I 

^ + + 1 1 ^ ^ 

IIJGFICZZ 1 I I X I X I I 

j. ^ ^ + 1 1 ^ 

jIJGFIErZ I X I X I I I I 

j. ^ + ^ ^ ^ ^ 

IIJGFIEWZ 1 X I I I I X I 

^ 1 1 4. + 4. ^ 

JIJGFIEZZ 1 X 1 X i I I I 

J. + + 1 4. 4- ^ 

IIJGFIZZZ I X I I X I I I 

h + f + + + ^ 

lUGFOCZZ I I I X I X j I 

|. 1 + 1 1 4. ^ 

I IJGFOErtZ I X I I I j X I 

|. 1 1 + + 4. ^ 

IIJGFOEZZ ! i X i I I I 

h + + + f + i 

IIJGFOZZZ j X i t X I I I 

^ + 4. 4- + 4. _ — 4 

lUGFUCZZ I I I X 1 X I I 

^ 1 1 1 4. 1 4 

JUGFUETZ I I X I I 1 I 

^ + 4- + 1 1 4 

IIJGFJEaTZ I X I I I I X I 

\- + + + + + ^ 

IIJGFUEZZ I 1 X I I I I 

^ ^ ^ 1 1 4. ^..4 

[IJGFaZZZ I X I 1 X I I I 

|. + + 4. 1 4. 4 

lUGFi^CMB I I I i I I 

|. + f + 1 1 4 

|IJGFi*C/JB I 1 I I I I 

^ + 1 + 1 4. 4 

IIJGFXCMB I I I I I I 

[ + 1 + + + i 

lUGFXCi^B I I I i I I 

^ + + 4. 4. 1 4 

IIJGPYCWB till I I 

^ 1 1 + 4. 1 4 

lUGQICZZ I I 1 X I I I 

I. ^ ^ + 4. 4. 4 

IIJGQIEk^Z I X I I I I X I 

^ 4. 4. 1 1 4. 4 

lUGQIEZZ I I 1 I I X I 

I- + + + f f ^ 

JIJGQIZZZ I I 1 X I j I 

|. 4. 4. 4. 1 _ 4. 4 

IIJGQOCZZ I I I X I I I 

I- + + f f f ^ 

IIJGQOEMZ I X I I I I X I 

^ 4- 4. 1 4. ..4. 4 

IIJGQOEZZ III! I X I 

Y 1 4. + 4. 4. 4 

IIJGQOZZZ I I I X I I I 

Y ^ 4. 4. 4. 4.-__ 4 

IIJGQUCZZ I I I X I I I 

Y + 4. 4. 4. 4. 4 

1 IJGQUEWZ I X 1 I I I X I 

L X X X X X J 
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r T T T T T 1 

I I I I I PL/I 1 I 

|SDMOD I I I I Optiiiiziag|A.merican National! 
I Names ! COBOL | PL/I |RPGII| Compiler | Standard COBOL | 

i. 1 1 1 1 1 ^ 

IIJ3QUCZZ I I I X I i I 

j. 1 1 ^ ^ ^ ^ 

1IJ3QUEZZ I I I I I X I 

[ -I- f + + +— ^ 

IIJ3QUZZZ I 1 I X I I I 

h + + + -h 1 ^ 

IIJ3QWCWB I I I I I I 

^ 1 1 + 1 1 ^ 

|IJ3QXCiJB till I I 

j. 1 + 1 1 1 ^ 

lUGRYCrfB I I I I I I 

1- 1 f + + + ^ 

|IJ3SyCiJB I I I i I I 

h + + ■»■ f f ^ 

IIJ3UICZZ I I I I X I I 

F + 1 + + — + ^ 

lusaiE^z 1 X I I I I X I 

h + + + + f ^ 

IIJ3UIEZZ I X I X I 1 I I 

^ ^ ^ ^. ^ 1 ^ 

IIJ3UIZZZ I X I I I I 1 

^ + 1 -^ 1 ^ ^ 

[IJGUOCZZ I I I I X 1 I 

^ -^ 1 + ^ _| ^ 

|IJ3U0E^Z I X I I I I X 1 

I- + + + + -I- ^ 

IIJ3U0EZZ I I X I I I I 

I- + + + + + ^ 

IIJ3U0ZZZ ! X j I I I 1 

j. ^. 1 ^ 1 1 ^ 

IIJ3UUCZZ I I I I X I I 

^ 1 1 + ^ 1 4 

|IJ3UaE«Z I X I I I I X I 

j. 1 1 + 1 ^ ^ 

IIJGUQEZZ I I X I I I I 

h f + + + + ^ 

lUGUJZZZ ! X I j I I I 

^ 1 + ^ 1 1 _ ^ 

IIJ3UWCWB I I I I I I 

lUGUXC/JB I I I I I 1 

i. 1 1 ^. ^ — _ ^ ^ 

IIJ3VIEWZ I X I I I I X I 

j. ^ ^ 1 1 1 ^ 

lUSVICZZ I I I X I X I I 

j. + 1 ^. ^. ^. ^ 

IIJ3VIEZZ I X I X I I I I 

I- -1- -1- + + + — -1 

JIJSVIZZZ I X I I X I I I 

j, 1 1 + ^. 1 ^ 

IIJ3V0CZZ I I I X I X I I 

i. 1 4. + + ^. 4 

|IJ3V0E^Z I X I I I I X I 

i. 1 ^- 1 1 ^. ^ 

IIJ3V0EZZ I I X I I I I 

i. 1 ^. 4. 4. 4. 4 

IIJ3V0ZZZ I X I I X I I I 

h + + + + f ^ 

IIJ3VUCZZ I I I X I X 1 I 

j. 1 1 1 1 4. 4 

IIJGVaEi^Z I X I I I I X I 

L X X i i X J 
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r T — ■ T T T T ^ 

I I I i I PL/I I I 

i SDMOD 1 1 I I Optimizing I ftmerican National| 
I Names |COBOL|PL/I | RPGII | Compiler ] Standard COBOL | 
y + 1 ^ 1 1 ^ 

IIJGVQEZZ 1 I X I I I I 

j. ^ ^. ^ 1 1 ^ 

IIJ3VCJZZZ 1 X I t X I I I 

I- + + + + f ^ 

I IJ3VWCWB I I I I I I 

^ + ^ 1 1 1 ^ 

|IJ3VXC^B I I I I i I 

|. 1 + ^ 1 ^ ^ 

IIJGWCZZU I I I I K I 1 

|. 1 1 1 1 + ^ 

IIJSWCZZZ I I I I K I I 

L X X X X X i 



Nft-ME LIST FOR iJORK FILE TYPE, MODULES ( rypEFLE= i^OR K) 

SDMODxx name = IJGabcde 

a = r SDMODW specifies riOLD=YES 

= W SDMODW does not specify H0LD=yE5 

b = C ERROPr=yES and ERREXr=YES 

= E ERROPr=yES 

= W RPS version of module 

= Z neither is specified 

c = N NOrEPNr=YES 

= R M0TEPNr=POINrR/J 

= Z NOIEPNT is not specified 

d = C CONTROL=Y£S 

= Z CONTROL is not specified 

e = T RDONLY=YES and UPDA.TE = YES 

= U UPDATE=YES 

= Y RDONLY=YES 

= Z neither is specified 

S^steTi_I/0_Modules 

iJSTwt^Jcr 

IJG.JEZZU 
IJGWEZZZ 
IJGWZNZZ 
IJ3WZRZZ 



Note: See "Required IOCS Modules" before deleting modules witn tne iJG prefix. 
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DUMOD 



DUMODFx name = IJNabcde 



a = D 

b = I DUMODFI 
= OUMODFO 

C = C ERROPr=YES and ERREXr=YES 
= E ERROPT=YES 
= Z neither is specified 

d = Z 

e = Y RDONLy=YES 

= Z RDONLY not specified 

r T T T T T 1 

I I I I i PL/I I I 

I DUMOD I I I I Optimizing! American i^ational| 
I Names j COBOL | PL/I |RPGII| Compiler | Standard COBOL | 
l- + + -+ 1 f 

JIJNDICZZ I I I X I X I 



I-- 
IJNDIZZZ I I I X I I 



^ + + 1 1 1. 

IIJNDOCZZ 1 I I X I X I 



l- + + +- 

JIJNDOZZZ I ! \ 
L i X -L. 
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Required IOCS Modules 



Tlie following prea3se:iiDled IOCS modules are required vJhen cataloging anS/or link-editin: 
IBM con[iponents to the core image library. 

^2^iil§_li§.ED§s lZte3_of ^Storage 

IJFFZZWN 960 

IJF^EZZZ 280 

IJFWZNZZ 424 

IJFWZZZZ 232 

IJSFIEIZ 746 

IJ3i^fEZZU 868 

IJGWEZZZ 796 

IJ3;^ZNZZ 902 

IJ3WZRZZ 840 

IJJCPA.1N 838 

IJJCPDV 750 

IJJCPDVl 694 

IJJCPDV2 358 

IJJCPDO 854 

IJJCPDON 798 

IJJCPDl 718 

IJJCPDIW 762 

IJJCPD2 478 

IJJCPD3 350 

IJJCP\^ 343 

IJJCPVl 271 

IJJCP72 68 

IJJCPO 389 

IJJCPON 317 

IJJCPl 311 

IJJCPIN 239 

IJJCP2 128 

IJJCP3 58 

IJNDIEZZ 868 
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r T 1 

j Number of | Core Image | 

I Transients j Library Blocks j 
|. 1 ^ 

I 11 I 12 I 

L J J 

l£§:0.sients 
$$BODh::L 

I $3B0DAIM 
$$BODMN 
$$B0DAI1 
$$B0DA.01 
$$B0DA02 
$$B0D?V03 
$$BODhOti 
$$BODA.RP 
$$BODARS 
$$B0DMJ1 

r T 1 

I Number of j Source Statement | 
j Macros I Library Blocks | 
y 1 ^ 

( 3 1 1,268 I 

L X J 

SQJRCE STATEMENT LIBRARY 

File_Def inition_Macros 

E-DA.MOD 
E. DAMODV 
E.DTFDA 

itorag_e_Reguirements 

Figure 8-1 defines the storage requirements for DAMOD. The following are the storage 
requirements for DTFDA. 

DIFDA_{^Def ine_The_Filej^__Direct-Access_Device)__r^ 

RECFORyi=FIXUNB requires 205-225 bytes, depending upon imperati\7e macros used in tne DTF. 
VERIFY=YES requires UO-80 bytes, depending upon imperative macros used in the DTF- 
AFTER=YES requires 80 additional bytes. 



Support for RP3 requires 512 bytes for each open DTFDA to be available in the GETVIS area 
of tne partition. This area is allocated during open; it is used to generate RPS channel 
programs. 

RECFORM=SPNUNB requires 282-378 bytes, depending upon the imperative macros used in the 
DTF. 

VERIFY=YES requires 64-72 additional bytes, depending upon tne imperative macros useS in 
the DTF. 

AFTER=5fES requires 88 additional bytes. 
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AECFORyi=L)NDEF requires 265-285 bytes, depending upon the imperative macro used in the 
DTF. 

VERIFY=YES requires 40-80 additional bytes, depending upon the innperative macros used in 
the DTF. 

AFTER-YES requires 16 additional bytes. 

RECFORM=VARUNB requires 216-330 bytes, depending upon the imperative macros used in the 
DTF. 

\/ERIF5f=yES requires 64-72 additional oytes, depending upon the imperative macros used in 
the DTF. 

AFTER-YES requires 88 additional bytes. 

Relative addressing increases the size of the DTF 60-80 bytes plus 8 bytes per extent. 
(See DOS/VS Supervisor and I/O Macros listed on the front cover of tnis manual.) 

DAMODJ^Oirect- Access _Deyice^Module)^ 

r 1 

I Formatting! 
I Module I 

r — ' T T -I- + T T T T 1 

I III I AFTER I I I |RPS Version | 
I I Basic 1 j I and I j | | of | 
|RECFOR)^=|ModuleilDLOC| AFTER | IDLOC | RELIRK j HOLD | ERREXTJ Logic Module j 
|. 1 1 1 1 1 1 1 ^ ^ 

JFIXUCJB 1 636 I +180| +304 j +4841 +212 j +84| +28 | 1948 | 
^ 1 1 ^ 1 + 1 1 1 ^ 

lUNDEF I 796 | +208| +216 | +426| +208 | +88| +28 | 2152 | 
|.__.. + 1 ^ ^ ^ 1 1 1 ^ 

IVARUNB I 686 | +2101 +298 | +508| +226 | +84| +34 | 2084 | 
^ + ^ 1 1 ^ ^ ^ 1 ^ 

ISPMUNB 12320 I +316| +1004 |+1320| |+104| +32 | 4096 i 

L X ± X X X X X X J 

Figure 8-1. DAMOD — Storage Requirements 

Notes : 

1. Basic Module includes coding to handle either FXXUNB or UNDEF records and the 
WRITEKY, READKEY, READID, HRITEID, SRCHM, VERIFY, and CONTROL functions. 

2. AFTER includes coding to create the tile and to handle tne RZERO option. 

3. IDLOC includes coding to return tne record identifier to the user in a location ne 
specifies. 

4. Specification of trailer label processing in the DTF increases tne size of each 
module by 50 + 20 bytes. 

5. RDONLY=YES changes the size of the module -50 to +50 bytes. In addition, the user's 
program must provide a 72-byte save area each time the module is reentered. 

6. RELTRK may be specified for SPNUNB records. This specification requires no 
additional bytes. 

7. RPS versions of tne logic modules include support for all otner valid options for 
each record format. 
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r — - 1 

1 Libraries | 

L J 


r 

1 Core Ima 


T 

ge 1 
1 _ 


Source 


1 

Statement | 


H *" ~ T 

1 Transients | 

L J. 


T 

Blocks 1 
J 


L^acros 


T 

1 
1 


7 

Blocks 1 


r t 

1 19 ! 

L X 


19 1 
x_ 


3 


1 

I 
_1 


503 1 
J 



CORE IWA-GE LIBRARY 



Transients 



$$?^BERR7 
$$B0DI01 
$$B0Dia2 
$$B0DI03 
$$B0DI04 
$$B0Dr05 
$$B0DID6 
$$B0DI07 
$$B0DI08 
$$B0DyiS3 
$$B0DMS2 
$$ BODS MO 
$$BOD3P0 
$$B0DUCP 
$$BOVDyiO 
$$BOWDMO 
$$B35'*0I 
$$B3540O 
$$B35400 



SOURCE STATEMENT LIBRARY 



File Definition Macros 



E.DTFDU 

E.DUMODFI 

E.DUMODFO 



Storage^R.equi re[ne nts 

Figures 9-1 and 9-2 specify the storage required by DTFDU and DUMOD. 



DTFDU (Define rhe_File_ Diskette Unit) 

r T 

I I CMDCHN 

I |. 

I TYPEFLE I 1 2 13 26 
^ + 

I INPUT I 152 160 248 352 
|. ^ 

I OUTPUT I 160 168 256 360 

L i 

Figure 9-1. DTFDU — Storage Requirements 
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DUMOD_(.Diskette_ynit_Module). 

r T T T T T "*T 1 

I Moiule I Basic \ RDONLif j ERROPT j ERROPT | ERROPT | ERROPT j 
I L^ayie | Module j | j RDONLif j ERREXT | LRREXT | 

I I I I I I I RDONLYi-l 
|. ^ ^ ^ 1 1 1 ^ 

I DUMODFI I 788 j 776 j 868 | 848 | 924 j 902 | 
^ 1__ + 1 1 1 + ^ 

I DU>dODFO I 632 | 594 j 696 | 642 ! 1078 | 1024 | 
|. X X X X X X ^ 

I ^For RDONLY=yES, the user's program must provide a 72-byte save area j 
I eacn time the module is reentered. j 

L J 

Figure 9-2. DUMOD — Storage Requirements 
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r T 1 

I I'Junnber of | Core Image | 

I Transients j Library Blocks j 

j, 1 ^ 

1 26 I 34 I 

L X J 

l£§:Q^ien,ts 

$$BCISOR. 
$$BENDFF 
$$BENDFL 
$$BINDEX 
$$BOISRP 
$$BOIS01 
$$BOIS02 
$$BOIS03 
$$BOIS04 
$$BOIS05 
$$BOIS06 
$$BOIS07 
$$BOIS08 
$$BOI309 
$$BOIS10 
$$B0IS11 
$$BORrVl 
$$B0RrV2 
$$BSErFF 
$$BSErF3 

$$BSErFa 

$$BSErFI 

$$BSErFL 

$$BSErL 

$$BSErLl 

$$BSErL2 



r T 1 

I Number of | Source Statement | 
I Macros I Library Blocks j 
|. 1 ^ 

i 5 I 2,717 1 

L X J 



SOURCE STATEMENT LIBRARY 

Macros 

I!II;E_DEFINITION 

E.DTFIS 
E.ISMOD 

IMPERATIVE 

E.ENDFL 
E.ESETL 
E.SETFL 
E.SETL 
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storage _Require[neiit 5 

Figure 10-1 defines the storage requiretients for ISMOD. The storage requirements for 
DTFIS are: 

^rFIS_(_Oef ine_the_File_Indexed_Se3uentiai)__rabl^ 

1. IORDUr=LOAD requires 248 bytes plus 4 bytes per disk extent specified, plus 8 bytes 
for I0AREA2. 

2. lOROUr^ADD requires 530 bytes plus 4 bytes per disk extent specified plus KL (tne 
length of the key) . 

3. I0R0UT=RErR7E requires 276 bytes plus 4 bytes per disk extent specified, wnen 
TirPEFLE=SEQNTL. 

U. IOROUT=RErRVE requires 292 bytes plus 4 bytes per disk extent specified when 
TyPEFLE=Rft.NDOM or RANSEQ. 

5. IOROUr=ADDRTR requires 548 bytes pluo 4 bytes per disk extent specified plus KL (the 
length of the key) . 

6. IDROCJr=ADDRTR, rYPEFLE=RANDOM, INDARLA=name, and INDSIZE=n require 572 bytes plus 4 
bytes per disk extent. 

7. Support for RPS requires 384 bytes for each open DTPIS to be available in the GETVIS 
area of the partition. This area is allocated during open; it is used to generate 
RPS channel programs. 

ISMOp_ (Indexed. ^Sequen tia l, Module) 
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Figure 10-1. ISMOD Storage Requirements (Part 1 of 5) 
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sRETRVE 
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Figure 10-1. ISMOD Storage Requirements (Part 2 of 5) 



I RECF0R}4= 
i- 

n 



IOROOT=ADDRTR 



rirPEFLE = 



RANDOM 



SEQNTL 



.^ ^ ^ J ^ 

JCORDATA JERREXT | CORDATA | HOLD ] 

H I 



I I 



ERREXr 



•T T T T 

j CORDATA I I0AREA2 j HOLD | ERREXT 



--'i'-^^^—^i—ir^T^'^^J^-^rrr-^—^-'^-r—i 



FIXUNB 



3252 1+320 



1+534 



+ 718 



i+304 13502 1+94 



i+386 1+278 1+510 
4 1 + 

1+386 1+278 1+528 



FIXBLK 



3468 1+376 



1+554 



+ 826 



1+304 13716 1+272 



BOTH 



3712 1+372 
X X 



1+588 
.X 



+ 834 



1+320 13962 1+274 

-X X X 



1+386 1+294 1+558 
.X X X 



Figure 10-1. ISMOD Storage Requiremeats (Part 3 of 5) 



I RECFORyi'= 
^ 

I FIXUMB 
|. 

I FIXBLK 

F 

I BOTH 

L 



I0ROUT=ADDRrR 



1 

I 

^ 

TyPEFLE=RANSEQ | 

T T T T ^ 

I CORDATAJ ERREXTJ CORDATAJ HOLDJ 
1 I |. ^ I 

I I I ERREXT I I 

I II II 
4. ^ 1 1 4 

42661 +316 I +556 j +750 |+384| 
+ + + + 4 

4494| +372 | +584 | +856 |+384| 
+ ^ ^ ^ 4 

47261 +248 j +616 | +864 |+400| 
X - X X X J 



Figure 10-1. ISMOD Storage Requirements (Part 4 of 5) 
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RPS Version of Module 



IOROUr= 



LOAD 



ADDRTR 



|1540 

L 



I0AREA2= 



NO 



YES 



T T T r 

I I I HOLD 1 
j. 1 1 ^ 

I HOLD| CORDATA-I CORD?VTA| 
y ^ ^ ^ 



T T T 

I I I HOLD 

I I j. 

1 HOLD|CORD?^r?^|CORDArA. 

\- + + 



|6828|+4281 +428 |+852 
.X X X X 



|6478| +3401+426 

-X X X 



1+766 

-J 



Figure 10-1. ISMOD Storage Requirements (Part 5 of 5) 

Notes: 

1. Whien RECFORiyi=BOrH is specifiei, trie module processes FIXUcJB and FIXBLK records. 

2. For CORINDX=YES, add 212 bytes. 

3. RDONLY=!ifES Changes the .tiodule size by ±50 bytes with the following exceptions. i^hen 
IOROar=ADD or IOROUT=ADDRTR, the Tiodule changes in size +60 to +100 bytes. xn 
addition, the user's program nust provide a 72-byte save area each time the module is 
reentered, regardless of function. 

4. RPS versions of the ISAM modules include support for all other valid options. 
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Libraries 



;ore Image 



^ ^ 

I Source Statement | 

^ 



^ ^ 1 ^ 

I Transients! Blocks | Macros | Blocks | 
[. 1 1 1 

18 1 8 I 6 I 278 



CORE iyiD,GE LIBRARY 



Transients 



Sam2le__Problemj 



Phase 



I DisK Extent Numoer 
I. ^ ^_. 

!1 12 |3 
I 1 1_. 






ASSE.VIBLE jSYSLNK [SYSOOl |SYS002 |SYS003 

I I ! 

LIWKEDIT I SYSj^lMK jSYSOOl (- 

I 1 i 
EXECUTE |- |- 1- 
J. X X 



$$ABEEAO 3895 ERP Phase 1 

$$ABEEAP 3895 EEP Phase 2 

$$ABERAQ 3895 OBR record builder 

$$ABEEAE 3895 MDE record builder 

$$A.BERRS Error Recovery Procedure 

$$BCMR01 CLOSE 

$$BMMR20 Message Writer 

$$BOMR01 OPEN 

SOURCE STA^TEMENT LIBRA.RY 



Macros 



Figure 11-1. .^jICR -- Sample ProDle.Ti File 
Requirements 



F!ILE_DEFINITIOW 

E-DTFMR 

E.MRMOD 



IMPERATIVE 

E.DISEN 
E.LITE 



r 


T 




-T 


1 


jCard C 


ols 


|Card Cols. 


1 Cards Retrieved 

L 


173-76 

1 




1 77-80 

-X - 


r 


T 




t 


jCATALS Z.MCRl 


1 






iBKEND Z.MCRl 


!$477 




1 0001-0071 


1 MCRl Source Deck 


I 






i (71 Cards) 


1 






1 BKEIJD 
1 


1 
1 






1 

\ChThLS Z.MCR2 


1 

1 






j BKbND Z.MCR2 


|$477 




1 0001-0115 


|MCR2 Source Deck 


1 






! (115 Cards) 


1 






1 BKEND 


1 







L X X J 

Figure 11-2. MICR ~- Sample ProDlem Card 
Decks 



SAMPLE_PROBLEMS 

Z.MCRl 
Z.MCR2 



SrORA3E_REQUIREMENTS 

DrFMR_iDef ine_The_File_Magnetic_Character 
Reader) Table Requirements : 

If A.DDRESS=DUAL is specified, the table 
requires 264 bytes. 

If ADDRESS=DUAL is not specified, the taole 
requires 250 bytes. 



MRMOD (Magnetic Character Reader Modu le) 

If ADDRESS=DaA.L is specified, the module 
requires 1,050 bytes. 

If A.DDRESS=DtJAL is not specified, the 
module requires 946 bytes. 



SAMPLE PROBLEM SUMMARY 



Figure 11-1 defines the files required for 
the MICR sample problems. Figure 11-2 
sho\vs the sample problem card decks 
retrieved from the source statement 
library. 
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The second 1U19 
Reader sa^iple prob 
aocuments from eac 
character readers 
botb vi/ith a single 
rfitn a dual addres 
CHECK and i^AITF lo 
tnat Tiust be press 
least one field fo 
REA.0 our control, 
reader are selecte 
zero depending on 
selected field is 
in error are rejec 
listed on a printe 
List feature is pr 
data is printed on 



Magnetic Character 
lem processes 250 
h of tiflfo magnetic 
(both of the same type: 

address adapter or Doth 
s adapter) , using READ, 
gic. The only controls 
ed are PROS SORT and at 
r the VALIDITY CHECK hAD 

Documents from one 
d into pockets one or 
whether or not the 
present. Documents read 
ted, and all data is 
r. If the Selective Tape 
esent on the printer, 

the leftmost tape. 



Documents from the second reader are 
selected according to a digit in the fiei.d 
read and printed on SYSLSr. If manual 
intervention is required on the second 
reader, a message is printed on SYSL03. 
This message is: 

INrERVENTION REQQIRED ON FILE2 



The program names are Z.MCRl and Z.MCR2. 
The 1U19 sample problems support the 
1255/1259. 



Instructions show how to remove the 
following optional features: 

1. Dual addressing adapter feature. 

2. Batch numbering. 

3. Pocket lignts. 

4. Selective tape list feature (printer) 



SYSL03 Output 

BG // JOB MCR SAMPLE PROBLEMS 

B3 // PAUSE END OF MCRl SAMPLE PKOBLElM 

BG 

BG INTERVENTION REQQIRED ON FILE2 

BG ECJ MCR 

BG // PAUSE END OF MCR SAMPLE PROBLEMS 



SX§I;ST_0ut2ut_SummarY 

Job control cards 

External symbol dictionary 

Source program listing 

Relocation dictionary 

Linkage editor input diagnostics 

Linkage editor storage map 

Document data listings. 
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r 

I Libraries 

|. ^ _ 

I Core Image | Source Statement 
|, ^ 1 ^ 

I Transients! Blocks | Macros | Blocks 
|. 1 1 ^ 

I I 19 I 3'4 I 2 1 994 

' L X X X 

S2KE_I^4AGE_LIBRAR^ 

$$BCE0V1 Monitor EOV/EOF 

$$BCMr01 Tape EOF/EOV input-f oritfard 

$$BCMr02 Tape CLOSE-alternate si^^itching 

$$BCMr03 Tape CLOSE input-backward 

$$BCiyiT04 Tape E0\7 output-forward 

$$BC!yiT05 Tape CLOSE 

$$BCMr06 Tape CLOSE-work files 

$$BCiyir07 Tape-alternate switching 

I $$BCMT08 Tape CLOSE-excluding work files 

$$BOMT0yi Tape OPEN message 

$$BOMT0W Tape OPEN message 

$$BOMr01 Tape OPEN input-forward-standard labels (Phase 1) 

$$BOiy!T02 Tape OPEN input-backward-standard labels 

$$BOMr03 Tape OPEN output forward-standard label 

$$BOMr0'4 Tape OPEN output-standard labels 

$$BOMr05 Tape OPEN I/O forward/backward nonstandard/unlabeied 

$$BOMT06 Tape OPEN work files 

$$BOMr07 Tape OPEN input-forward-standard labels (Phase 2) 

$$BONVOL Tape rewriting 



File Definition Macros 

E.DTFMT 
E.MTMOD 



Storac[e_Reguirements 

Figures 12-1 and 12-2 define the storage requirements for DTF.YlT and MTMOD, 

DrFMr_(.Def ine_rhe_File^ Magnetic Tape) Table Require men ts 

T:fPEFLE=^ORK requires 48 bytes per work file. 
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rne table requirements for INPUT and DUTPUT files are: 



r T T 

TYPEFLE= I RECFORM=| Basic 
I I Size 

j 1 Without 

1 i STDL.PiBELS 



T T 

ERROPT, 
ERREXr 
(Witnout 
STDLBiBELS) 



T 1 

Basic I ERROPr, 
Size I ERREXT 
With I (Witn 
STDLABELS | STDLABELS) 



-I- 



iNPur 



FIXUNB 

or 
FIXBLK 



96 



112 



I- 



V^ARUNB I 

or I 

VA.RBLK I 

-H- 

I QNDEF I 

}■ +- 

I SPNUNB I 

-I f- 

I FIXUNB I 
! or I 
I FIXBLK I 

I- + - 

j VARUNB I 

I or I 

I ^'ARBLK I 



109 



128 



92 

132 



108 
132 



OUTPUT 



86 



+ 10 



104 I +4 



98 



+ 10 



116 



h 



-+- 



84 



I UNDEF i 

h + 

1 SPNUNB I 132 
-J. X 



+ 4 
+ 



100 
132 



+ 4 



+ 4 



♦ Included in basic Size of Module. 
Figure 12-1. DTFMT -- Table Requirennents 
MTMQD (yiaqnetic Tape .Vlodule) 
r 



EBCDIC MOlGNETIC TA^Pc MODULE 



I" 



INDEPENDENT OPTIONS 



I R£CFORM= 

[ 

I FIXUNB/FIXBLK 

I- 

I VZ\RUNB/VARBLK 



I BASIC 
i yiODULE 
+ 



WORKA= 
YES 



CKPRTEC= 
YES 



READ- 
BACK 



I ERREXT 



688 



+ 80 



+ 112 
+ 108 



+ 96 
+ 84 



I +96 



824 



+ 112 



+ 96 



UNDEF 



I 560 

4 

I 1808 

.J. 



+ 80 



+ 120 
+ 260 



+ 16 



I +96 



I SPNUNB/SPNBLK 
L_„_ 



+ 300 



I +252 I 
-J. J 



Figure 12-2. MTMOD -- Storage Requirements (Part 1 of 3) 
Notes : 

1. Only one module is required for processing all files having a common RECFDRW. mis 
module can be generated with the options charted above. To determine the size of the 
module with the options, the number of option b/tes specified in tne chart must oe 
added to the basic module. 

2. RDONLY=YES, changes tne size of tfie module -50 to +50 bytes. In addition, tne user's 
program must provide a 72-byte save area each time the module is reentered. 
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WORK FILE MODULE 
T T-- 



I 1 witinout 
I r!^PEFLE=WORK | LNJOTEPiSTT 
1. 1 

1 witaoat ERROPT | 232 
|. ^ 

I itfitl ERROPT I 280 
|. 1 

1 itfitli ERROpr and | 436 

1 ERREXr I 

L X 



NOTEPlnT: 
T 



iTES 
424 
540 
654 



POINTS 
286 
380 
494 



Figure 12-2. MTMOD -- Storage Requirements (Part 2 of 3) 



ASCII MAGNETIC TAPE MODULE 



RECFORM= 



BASIC 
MODULE 



INDEPENDENT OPTIOi^S 
T T — 



WDRKA= 
YES 



CKPRrEC= 
YES 



T 

READ= I 

BACK I ERREXT 



1 FIXUNB/FIXBLK ] 824 
j. ^ 



+ 92 



+128 I +120 



I VARQNB/VARBLK 



968 



+ 112 



+ 56 



I +96 



UNDEF 



656 



+ 80 



I +96 I 
-J J 



Figure 12-2, MTMOD -- Storage Requirements (Part 3 of 3) 
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Libraries 



:ore Image 



^ ^ 

I Source Statement | 



-+■ 



r T T T 1 

irransients! Blocks | .Macros | Blocks | 
1. 1 1 ^ ^ 

12 I 2 I 5 I 722 I 



Q9RE_IMAGE_LIBRARY 

$$ft,BERRr Error Recovery Procedure 
$$BOOR01 OPEN 

SQ[JRCE_SrATEMENT_LIBRARy 

Macros 

f;iL!E_DEFINITION 

E.DTFOR 
E.ORMOD 

IWPER^ri\/E 

E.DSPL!ir 
E.RDLME 
E.RESCN 

Si;0RA3E_REQUIREMENrS 

Figure 13-1 defines tne storage requirements for ORMOD. 

ORMOD (Optical Reader Module --_Ejccept_ for the 3881 Optical Mark Reader) 











1 


INDEPE 


NDENT 


OPTIONS 




i 










h- 














J 






1 






1 


"T* 


1 
























I0AREA2- 1 








Basic 




CONrROL= 




I0AREA2- 


= 1 


^ORKA=| 


YES and | 


DEVICE=| 


RECFORyi= 




Module 




YE3 






iTES 




YES 1 


«ORKA=YES| 


+ 




-+- 





-+- 




-1- 







-+- 


1- 


^ 




FIXUNB 




892 




+ 220 






+ 76 




+ 60 1 


+ 96 1 




FIXBLK 




1256 




+ 264 






+ 56 




+ 28 1 


+ 84 1 




UNDEF 




848 




+ 22U 






+ 56 




+ 64 1 


+ 88 1 


12871/ 1 


UNDEF 
























BLKFAC = irES 




1180 




+ 258 






+ 56 




+ 24 1 


+ 80 1 


1287D 1 
























or 1 


FIXUNB 




1360 




+ 184 











1 


1 


1288 1 


UNDEF 




1256 




+ 188 











1 


1 



Figure 13-1. OPTICAL READER -- ORMOD Storage Requirentients 
DrFQR_ (Define The _. File; 1287 Optical Reader) Table Requirements 

1. RECFORM=FIXUNB requires 136 bytes. 

2. RECFORM=FIXBLK varies as a function of blocking. 

Size = 136 + (16 x blocking factor x number of I/O areas) 

3. REC:F0RM=UNDEF requires 136 bytes- 
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Sample Problem Summary 

Ttie 1288 sample problem is obtained by retrieving ttie sample problem for the 1287 journal 
tape mode of operation (Z.CRJT) and changing the cards with the sequence numoers 1058 and 
1071 as follows: For both cards change the parameter DEVICE=1287r to DEVICE=1287D. 
(Refer to the listing containing the source statements for the sample test program for 
journal tape processing). Figure 13-2 illustrates the files used by botn problems, and 
Figure 13-3 illustrates the card declcs that are punched when the sample problem is 
retrieved. 

The sample problem illustrating document processing for tne 1287 or 1288 optical 
reader (Z.ORDC) reads documents for data input into stn. input area, and then prints tnis 
data on SYSLST. Whenever the 1287 or 1288 document hopper empties, press end-of-file or 
replenish the stack. 

Any approved document type may be used because tne reference mark and data field 
coordinates are entered at program execution time. However, the data field cnosen to be 
read may not exceed six characters in length. 

Figure 13-4 is a sample input document. rne listing contains examples of keyed-in 
error corrections identified by comments. 

Note: /Jhen using this program on a 1288, remove the RESCN and DSPLY macro statements 
within sequence numbers 0091 and 0109. 

The sample problem illustrating journal tape mode processing for the 1287 optical 
reader reads undefined records from the 1287 optical reader into a work area from two I/O 
areas, and then prints these records on SYSLST. 

hny journal tape with a maximum record size of 38 characters is suitable for tnis 
sample problem. 

Figure 13-5 is a portion of a sample input journal tape. 



Disk Extent Number 



I- T T T T 1 

I Phase |1 1 2 |3 |4 | 
|. + 1 1 + ^ 

I Assemble jSiTSLNK jSiTSOOl | SYS002 |SirS003| 
iLink EditlSYSLNK JSYSOOI |- |- | 
I Execute j- j- |- j- | 
L X J. J. i. J 



Figure 13-2. OPTICAL READER — Sample Problem 
r T 



Cards Retrieved 



CATALS Z. CRDC 
BKEND Z.ORDC 
Document Mode 
Source Deck (179 
Cards) 
BKEND 

CATALS Z.CRJT 
BKEND Z.ORJT 
Journal Tape Source 
Deck (81 Cards) 
BKEND 



Card Cols. 
73-76 



$478 



$478 



T 1 

Card Cols 
77-80 



0001-0179 



1001-1081 



Figure 13-3. OPTICAL READER — Sample Problem Card Deck 
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SKSLq3_0at2Ut: 

// JOB DPnCAL READER SAMPLE PROBLEM 

EOJ OPTICAL 

// PAJSE END OF OPTICAL READER SAMPLE PROBLEM 



S5[SLSr_0uteut_Su[n[narY 

• Job control cards 

• Extarnal s/mbol dictionary 

• Source program listing 

• Relocation dictionary 

• Linkage editor input diagnostics 

• Linkage editor storage map 

• List of fields read from: 

for document sarnple problem, or 
for journal tape sample probleii. 







1 




/23^56 78 






Mmk 


tar 


• 
i 

i 


■■i 




OT-HM 




„„„ 


< 


MUNMT mmmnmm ana i» can 

05 2M.680 357 9 8 

01 36925 4-68 1 

02 13579 205 2f 
01 725»f6 763 63 

03 5638»f 920 57 
01 *f2679 f3l 76 
Of 6639Z II 7 33 

7 -sr 

13579 

MikT Mk. m. <KU 

021057 "~ 

Mil 1 —■ 


M 


MM 




?500 

3»+9 
i29 
1^7 
995 
3960 














8 
8 


578 
1 50 
728 




Figure 13-4. OPTICAL READER — Sample 

Input Document for Document 
Mode Processing 
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012 


345b 


769C 


&ea 


4Sb7 


690S 


834 


Sb76 


901T 


345 


b769 


018N 


ASh 


7690 


183$ 


5k7 


6901 


834X 


b7a 


9018 


345C 


769 


0183 


45bT 


ARO 


1834 


5b7Z 


901 


8345 


b76/ 


018 


34Sb 


769C 


183 


45b7 


690S 


834 


Sb7& 


901T 


345 


b7&9 


018N 


45b 


7690 


183S 


5b7 


6901 


834X 


b76 


9018 


345C 


75H 


0183 


45bT 


690 


1834 


5b7Z 


qai 


8345 


b76/ 


018 


34Sb 


769C 


183 


45b7 


690S 


834 


5b76 


901T 


345 


b769 


018N 


45b 


7690 


183S 


5b7 


6901 


834X 


b76 


9018 


345C 


769 


0183 


45bT 


690 


183 4 


5b7Z 


901 


8345 


b76/ 



Figure 13-5. OPTICAL READER — Sample 

Input for Jouraal Tape Mode 
Processing 
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r 1 

I Libraries J 

|. ^ ^ 

I Core Image | Source Statement | 
). ^ ^._ ^ ^ 

I Transients I Blocks i Macros | Blocks ( 
|. 1 ^ + ^ 

I 2 I 2 I 6 I 382 I 

L i J. J J 



?QEE_I?5^3E_LIBRARY 

5£§LQsients 

$$A.BER?iN Error Recovery Procedure 
$$BOOR01 OPEN 

SOyRCE_Sr^TEMENT_LIBRARY 

DRMOD_(^3 8 8 6_0£tical_Cha^acter_Reaaer_^dodule)_ 

Macros 

1. go r.jiat Definition 

E. DFR 

E.DLINT 

E. DLINTIW (Inner n^acro, used only by the DLINT macro) 

2 • Fi ls_Def i niti on 

E.DIFDR 
E.DRMOD 

3 • i-Qe§.E§.ti ve 

E.SEIDEV 

SrORA3E_RE2yiREMENTS 

DRMOD: 

(Basic Size = 443 bytes) 

Basic + RDONLY=395 

Basic + SETDEV=773 

Basic + RDONLY + SETDEV=773 

DIFDR Table Requirements 
Size = 124+BLKSIZE+FRSIZE 
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r 1 

1 Libraries | 

|. ^ ^ 

I Core Image j Source Statement | 
|. ^ ^ ^ ^ 

I Transients I Blocks | Xlacros | Blocks | 
|. 1 1 1 ^ 

I 3 I 4 i 2 I 593 I 

L X X X J 



^^RlE_I^^3E_LIBRARY 

^^ansients 

$$ABERR[J Error Recovery Procedure (ERP) 

$$ABERR\/ ERP 

$$BERPrP ERP - 1018 with error correction feature 

SOURCE 5rft.TEMENT LIBRARY 

Fil e Definition M acros 

E.DTFPr 
E.PrMOD 

SrORA3E_REQtJIREMENrS 

DTEPr ( Dgf ine_The_File : Pager Tage) _ Table Requirements 

INPyT_FILE 

Tlie possible table specifications and sizes are: 

1. No translations, no shifts, and no deletes require 72 bytes. 

2. TR?iNS=name with no snifts and no deletes requires 76 bytes, 

3. TRANS=name, SC:AN=name, RECF0R!4=FIxaNB require 110 bytes. 
k. TR?ilSlS=na[ne, SC^N=name, RECFOR.yi=UNDEF require 94 bytes. 

OUrP[Jr_FILE 

rne possible table specifications and sizes are: 

1. No shifts require 69 bytes. 

2- Shifts require 83 bytes. 
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prM0D_{_Pa2er_ra2e_Module)_ 

rhe module specifications and sizes are specified in Figure 15-1. 

1 













lupur 




1 


OUTPUT 










1 


2671 


-T- 

1 
1 


1017 


-+- 

1 
1 


1018 










1 




1 




1 




1. 


No parameters specified 


(no 






244 




288 


1 






translation, no shifts and 


no 










1 






deletes) 






1 




1 




1 
1 












1 




1 




1 




2. 


rRA.NS-YES with no shifts 
no deletes 


an 


d 


1 


310 


1 


354 


I 

1 
1 












1 




1 




1 




3, 


rR?lNS=YES, SC?\N=YES, 
RECFORM=FIXUNB 






1 


535 


_J- 


570 


1 

1 
1 












1 




T 




1 




^. 


rRA.NS=YES, SC^N=YES, 
RECFORM=UNDEF 






1 


436 


1 


474 


1 

1 
1 












1 




1 




1 




5. 


lSIo shifts 






1 




_ 1 




1 
1 


352 










1 




1 




1 




6. 


Shifts 














1 


570 



ti^te: If module 2 is used, all records require translation. 
Figure 15-1. PTMOD -- Storage Requirements 
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j Libraries 


1 Core Ima 


ge 1 
1 


Source 


Statement 


1" T~ 

1 Transients | 

h +- 

1 30 J 

L X 


T 

Blocks 1 

-h- 

30 1 
_ x_ 


Macros 
11 


"T 

1 

1 
_X_ 


Blocks 
6,8U8 



SQRE_IM^3E_LIBRARY 

i!?!i.[l§isQts 

I $$B0SDB1 

$$B0SDC1 

$$B0SDC2 

$$B0SDC3 

$$BOSDE^ 

$$B0SDI1 

$$B0SDI2 

$$B0SDI3 

$$BOSDIU 

$$B0SDI5 

$$B0SD01 

$$B0SC)02 

$$B0SD03 

$$B0SD04 

$$B0SD05 

$$B0SD06 

$$B0SD07 

$$B0SD08 

$$B0SD09 

$$BOSDRP 
I $$BOSDR£ 

$$BOSDRS 

$$B0SDW1 

$$B0SDi^2 

$$B0SDW3 

$$BOSD00 

$$BOSD01 

$$BOSD02 
[ $$BOSD03 

$$B02321 

SOURCE STATEMENT LIBRft.RY 

File _ Def JQitionMacros 

E.DTFSD 

E.SDMODFI 

E.SDMODFO 

E.SDMODFLI 

E.SDMODJI 

E.SDMODUO 

E. SDMODCJU 

E.SDMODVI 

E.SDMODVO 

E.SDMODVQ 

E.SDMODW 
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STORA3E_RE2UIREM£NrS 

Figurss 16-1, 16-2, and 16-3 -specify tna storage required by DTFSD and SDlVIOD, 

DIf!SD_(_Define_rhe_Filej_ Sequential _D^SD)_ 



RECFORyi= 



TYPLFLE 



T T 

li'^pur I ourpari ^jork 
^ ^ |. ^ 

with I itfithout I I with | without 



UPDATE I UPDATE 



+ - 



+ - 



UPDATE I UPDATE 



COl^i^ROL 
YES 



FIXBLK 

or 
FIXUNB 

h 

VARBLK 
or 

VARUNB 

SPNBLK 

or 
SPNLJKB 



176 



I 152 
■+ 



160 



152 



152 



+ 24 



192 
240 



I 152 
I 188 



170 
I 

244 






+ 24 
+ 24 



l- 



.| 1 ^ 1 ^. 

I 152 I 162 i 152 I 152 1 

.X X X X X. 



I UNDEF I 192 

L X 



+ 24 



Figure 16-1. DTFSD -- Storage Requirements 

Support for RPS requires 256 bytes for eixch open DTFSD to be available in the GEIVIS area 
of the partition. This area is allocatea during open; it is used to generate RPS cnannel 
progranns. 
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SDMOD (SEQUENTIAL DASD MODULE) 



I" 

I c 

H 

SDMODFO 
SDMODFU 



Module Name 



Basic Module 



TRUNCS 



CONTROL 



ERROPT I HOLD 



ERRCPT 
ERREXT 



RECFORM=SPWBLK | 
RECFORM=SPNUNB | 



SDMODFI 



M62 



+ 80 



+ 28 



+- 



+ 1414 I 



+ 228 



sue 

798 



+ 136 



+ 28 



+ 28 



h- 

I c 

I" 

I c 

I-- 

I ( 

K 

SDMODVO 
SDMODVU 



+ 64 I 
+164 I +96 



+ 200 
+ 252 



-+- 



+- 



SDMODUI 



533 



+ 28 



+ 100 



+ 171 



SDMODUO 



653 



+ 28 



+ 68 I 
— +- 



+ 116 



SDMODUU 



941 



+ 28 



+148 I +40 



+ 248 



SDMODVI 



729 



+ 28 



+ 104 



+ 1! 



300-400 



-+- 



-+ + 

+ 68 I 
+ + 

+176 I +76 



1045 
1086 



+ 28 

+ 

+ 28 



+ 120 
+ 296 






1050-1150 
1500 



-+- 



-+ 



+148 1 +10 I +246 
± X J. 



SDMODW 1 572 | | +22 
L X X X 

*The HOLD function does not apply to these modules. 
Notes: 

1. For SDMODW, NOTEPNT=YES requires 206 additional bytes: NOTEPNT=POINTRW requires 144 
additional bytes, UPDATE=YES requires 40 additional bytes. 

2. RDONLY=YES changes the size of the module -50 to +50 bytes. In addition, the user's 
program must provide a 72-byte save area each time the module is reentered. 

Figure 16-2. SDMOD — Storage Requirements - Non-RPS Version Module Sizes 



1394 
SDMODUI 



Module Name 
SDMODFI 
SDMODFO 
SDMODFU 



-+- 



SDMODUO 
SDMODUU 
SDMODVI 
SDMODVO 
SDMODVU 
SDMODW 



Basic Module 
884 
1020 



908 
1050 
1496 

986 
1522 
1762 
1934 



TRUNCS 
+ 174 
+ 142 
+ 142 



T 1 

RECFORM=SPNBLK 
RECFORM=SPNUNB 



-+- 



+ 436 
+ 1224 
+ 1524 



Note: Each RPS version of the module supports all other valid options. 
Figure 16-3. SDMOD — Storage Requirements - RPS Version Module Sizes 
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Module Outline 
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virtual storage 265 
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General Considerations 



N o n-SVA-eliqi bl egnases : 



mis section discusses the three elements 
necessary to run VSAM: VSA.vi itself, its 
utilities (Access Method Services), and the 
ISAM Interface program. VSAM may run by 
itself or with either or both of the other 
two programs. 



IKQVDCN 
IKQVDQ 
IKQVDUMP 
lKQ\/EDh 

ik;;vl?^sf 

IKQv7Rr 
IKQVSCTAr 

RELOCATABLE LIBRARY 



VSAM Data Management Modules 

^^RE-I^SE-liiBRARy; 

r T 1 

I I!£§.Iisi ents ( 15 | 
I Blocks I 17 I 
^ 1 ^ 

I Phases | 31 j 

I Blocks 1 321 1 

L X J 

I!£§.Qsients 
$$BACLOS 

$$bc:lc:ra 

$$BCV3AM 
$$BCVS02 
$$BCVS03 
$$BC:VS04 
$$B£NDQB 
$$BJIBFF 
$$BJIBOO 
$$BOD^DE 
$$BODADS 
$$BOVSA.yi 
$$BOVS01 
$$BOVS03 
$$BrCL03 

SVA-eli3_ible_ghases (see section "Loading 
VSAM Phases into the SVA") 

IKQVBEP 

IKQVCAr 

IKQ7CLC 

IKQVCLOC 

IK2VCL0S 

IKQVCLOV 

IKQVDNT 

IK2VDRP 

IKQVDrPE 

IKQVEDX 

IKQVEOV 

IK2VGEN 

IKQVJIBS 

IKQVLAB 

IKQVLASM 

IKQVMS3 

IKQVNEX 

IK2V0PEN 

IKQVPBF 

IKQVRBA 

IKQVRM 

IKQVSryi 

IKQVTyiS 



r T 1 

I Nuntioer of Modules | Number of Blocks | 
y ^ ^ 

I I 164 I 1.756 I 

■ L X J 

Modules 

$$BACLOS 
$$BCLCRA 
$$BCVSAM 
$$BC:VS02 
$$BCV303 
$$BCVS04 
I $$BENDQB 
$$BJIBFF 
$$BJIBOO 
$$BODADE 
$$BODADS 
$$BOVSAyi 
$$BOVS01 
$$BOVS03 
$$BrCLOS 
IGGOCLAB 
IGGOCLAC 
IG30CLAD 
IGGOCLAE 
IGGOCLAF 
IGGOCLAG 
IGGOCLAti 
IGGOCLAJ 
IGGOCLAK 
IGGOCLAL 
IGGOCLAN 
IGGOCLAP 
IGGOCLAQ 
IGGOCLAR 
IGGOCLAS 
IGGOCLAT 
IGGOCLAU 
IGGOCLAV 
IGGOCLA/J 
IGGOCLAX 
IGGOCLAY 
IGGOCLAZ 
IGG0CLA6 
IG30CLA7 
IGGOCLAS 
IG30CLBA 
IGGOCLBB 
IG30CLBC 
IGGOCLBD 
IGGOCLBE 
IGGOCLBF 
IGGOCLBG 
IGGOCLBH 
IGGOCLBL 
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IGGOCLBXI 

I330CLBN 

I330CLBQ 

I330CLBR 

I330CLB5 

I330CLBr 

I330CLB[J 

I330CLBW 

I330CLBK 

I330CLBY 

IG30CLB8 

I330CLC?\ 

I330CLCB 

I330CLC:D 

I330CLC3 

I330CLCL 

I330CLCO 

IGGOCLCP 

I330CLCR 

I330CLCS 

I330CLCK 

I330CLCY 

IG30CLC9 

IKQMX 

IK2ALL00 

IK2BF?l 

IK2BFB 

IKQBFC 

IK2BLD 

IK2BRP 

IK2CAS 

IK2CIR 

IK2CIS 

IK2CLC».r 

IKQCLE?i.[SI 

IK2CLMLK 

IK2CL0CL 

IK2CL0VY 

IK2CL0 

IKQCOVOO 

IK2DCN 

IK2DWr 

IK2DRP 

IK2DUMP 

IK2DUyiPC 

IK2EDX 

IK2E0\; 

IK2ERH 

IK2ERK 

IK23E[:J 

IK2GISIX 

IK2GPr 

IK2INr 

IK2I0A 

IK2I0B 

IK2IXE 

IK2IXF 

IK2IXS 

IK2JIB5M 

IK2JRN 

IK2KRD 

IK2LSlB 

IK2LASFr 

IK2LA.SyiD 

IK2LCD 

IK2LClSf 

IK2LCP 

IK2MDY 



IK2WCB^ 

IKQNEX 

IK20CMS3 

IKQOPN 

IKQOPN?VI 

iKgoPNcr 

IKQOPNDO 

IKQOPNHC 

IKQOPNNC 

IKQOPNOV 

IK20PNRD 

IKQOPNRP 

IKQ0PNU3 

IKQOPNUS 

IKQPBF 

IKQPFO 

IKQPOPOO 

IKQRBA 

IKQRCL 

IKQRDSOO 

IK2REN00 

IKQRQA 

IKQRQB 

IKQRQC 

IKQKRP 

IKQRTV 

IK2SCAT 

IKQ3CN 

IKQSCROO 

IKQSFT 

IKQSPM 

IKQSRG 

IKQSRT 

IKQSRQ 

IKQSTM 

IKQIMSD 

IKQTMSF 

IKQUPD 

IKQUPG 

IKQVDrPE 

IKQVEDA 

IKQVFY 

IKQVRT 

IKQVSM 

IKQVSMLK 

IKQVTCOO 

IKQWDSOO 

Linic-Edit State Tie n t s 
// OPTION CA.TAL 

INCLUDE IK2VSyiLK 
// EXEC LNKEDT 

Ignore notice "CONTEOL SECTIONS OP ZEEO 
LENGTH IN INPUT" given by the linkage 
editor at the end of the partition storage 
map. 

SOURCE STATEMEi.Jr LIBRARY 

r T 1 

I Number of ^dacros | Number of Blocks | 
y + _ ^ 

I I 26 I 1,602 1 

I L X J 

Ddacros^jEdited) 
A.CB* 
BLDVRP 
I DEOB 
DLVRP 
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EWDREQ 
I ENQB 

ERASE 

EXLST* 

GENCB* 
I IKQACB* 

IKQACB3 

IKQCB1+ 

IK2CB2* 

IKQER-AAC* 

IKQEXL3 

IIKQEXLST* 
IKQEPL* 
IKQRPL3 
MODCB* 
POINT 
RPL* 
SiiO'^ChT 
SHOWCB+ 
rCLOSE 
TESTCB* 
^RTBFR 
I *These macros are also required by VTAK. 

LOADING VSAM AND RPS PHASES INTO THE SVA 

The system procedure library contains 
procedures VSAHSVA and VSAMEPS to load 
IBM-supplied phases into the SVA, 

• Procedure VSAHSVA loads a set of 
selected system phases plus VSAM phases 
- but no EPS phases. 

• Procedure VSAMRPS loads a set of 
selected system phases plus VSAM and 
EPS phases. 

Loading tne SVA-eligiDle VSA>4 pnases into 
tiie SVh offers ths folloiving advantages: 

• yoa save virtual and real storage space 
in tne partitions if the phases are to 
be stiared between several partitions; 

• you save load time per job step. The 
pnases always remain in the SVh; even 
the IPL procedure may use a warm start 
copy; 

• the phases are protected against 
descruction by user program errors. 

Note; The SVA-GETVIS area is not used for 
\;SAM. 

Procedure VSAHSVA consists of statements 
and phase names as follows: 

set sdl=create 
$$bc:lose 

$$BCL0S2 

$$BCL0S3 

$$BCL0S4 

$$BEOJ 

$$BE0JS1 

$$BE0J4 

$$BE0J7 

$$BOCP01 

$$BOCP03 



$$BOFLPr 

$$BOPEN 

$$BOPEND 

$$BOPENR 

$$BOPEN0 

$$B0PEN1 

$$B0PEN3 

$$BOPEiNm 

$$B0PEN5 

$$B0PEN6 

$$BOPIGN 

$$B0SDC1 

$$B0SDC3 

$$B0SDI1 

$$B0SDI2 

$$BOSDm 

$$B0SD01 

$$B0SD02 

$$B0SD03 

$$B0SD04 

$$B0SD08 

$$B0SD09 

$$B0SDW1 

$$B0SD^2 

$$BOSD00 

$$BOSD01 

$$BOSD02 

$$BOSD03 

$$BOSD04 

$$BOSD05 

S$BOSD06 

$$BOSIGN 

$$BSETL 

$$BSErLl 

$$BSETL2 

$JOBCTLA. 

$JOBCTLE 

$JOBCTLN 

$JOBACCr,SVA. 

$JOBEXir,SVA 

$LIBSrAT,SV?l 

$MAINDIR,SVA 

$$BA.CLOS The following are WShyi 

$$BCLCRA phases 

$$BC:VSAM 

$$BC:VS02 

$$BCVS03 

$$BJIBFF 

$$BJIBOO 

$$BODhDE. 

$$BODADS 

$$BOVSAM 

$$BOVS01 

$$BOVS03 

$$BrCLOS 

IKQVBRP,SVA, 

IKQVCAr,3\7A 

lKQVCLC,SVh 

lKQVCLOC,SWh 

IKQVCLOS,SVA 

IKQVCL0V,3VA 

IKQVDCN 

IK2VDNT,S\/A 

IKQVDRP,S\/?k 

IKQVDrPE,3VA 

IKQVDUMP 

IKQVEDX,S\7A 

IKQVEOV,SVA 
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IKQVJIBS,SVA 
IKQVLhB.oVh 
IKQVLA.SF 
IKQVL?\Siyi,3VA. 

rKQVNEX,SVA 

IK2V0PEN,SV^ 

IKi;VPBF,SVA 

IK2VRBA,SVA 

IK2VRM,SVA 

IK2VRT 

IKQVSCAT 

IK2VSTM,SVA 

IKQVTMS,SVA 

/* 

/ + 

Procedure VSAMEPS consists of the 
transients, phases, and statements given 
for VSAMSVA (excluding the /* and /+) plus 
the following: 

IJGCyCMB,SVA 

IJGCYCWB^SVA 

IJGFHCMB,SVA 

IJGFHCWB,SVA 

IJGfXCBB,SVA 

1JGFXCWB,SVA 

IJGPYCWB,SVA 

IJGQ»CWB,SYA 

1JGQXCHB,SVA 

IJGEYCKB,SVA 

IJG5YCHB,SVA 

IJGTWNCT,SVA 

IJGOHC»B,SyA 

IJGOICHB,SVA 

IJGVIiCUB,SVA 

IJGVXCHB,S¥A 

IJHAVBBF,SVA 

IJHAVBBS,SVA 

IJHAVBCF,SVA 

IJHAVBCS,SVA 

IJHAVGBF,SVA 

IJHAVGBS,SVA 

IJHAVGCF,SVA 

IJHAVGCS,SVA 

IJHZXGZS,SVA 

IJIBWEHH,SVA 

IJIF»£H9,SVA 

IJISH£HH,SVA 

IJIV»EHN,SVA 

IJJCVAIN,SVA 

IJJCVDV,SVA 

IJJCVDO,SVA 

IJJFVBIC,SVA 

IJJFVIICSVA 

/* 



ti2te: rae $$B-transient3 aafl the $-paa3es 
are not part of VSAM and DOS/VS only 
includes their names in the systets 
directory list (SDL)*. HowsTer, as 
building the SDL can only be done 
concurrently with loading the SVA, the 
names of these transients and phases are 
also included in procedure VSAMSVA. If 
VSAM is not to run in the SVA, yoio. can use 
the IBM- supplied procedure SDL to include 
the non-VSAM phases and tran-=-.ients in the 
system directory list. 



* SJOBEXIT, $LIBSTAT, and $MAIKDIE are 
loaded into the SVA to improve 
performance. 

* $JOBAC:cr should be included if usinq tne 
IBM-supplie:i default. 

rhe SVA-eligible VSAM phases can oe divided 
into tw3 distinct groups, taat is the root 
phases that are to be loaded i/henever you 
itfant to use VSAM at ail, and the optional 
phases that are loaded only if certain 
conditioas are encountered in VSA>1 
processing. The latter phases reTiain in 
virtual storage until the job step is 
finished. 



VSAM Root Phaser 





j j size 


Function 


l?nase | (bytes) 





— 1 1 


Record management 


IIK2VRM 1 51,3 30 


routines 


1 1 


Open routines 


|IK2V0PEN| 22,600 


Close routines 


lIKQVCLOSj 2,8 00 


Label processing 


IIKPVLAB j 2,200 


routines 


S 1 


Catalog routines 


jIKQVCAr |]. 6 3, 9 00 


File table routines 


iIK2VLASyi| 1,200 


Message routine 


IIKQVMSG I 2,100 



[. 1. 1 { 

I Total 1 j246,150| 

L j. X J 



When certain other conditions are 
encountered in VSAM processing, other 
phases will be loaded into the virtual 
address area. These phases remain in the 
virtual address area with the originally 
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loaded phases until the joo step is enaed. 
The following additional phases can oe 
loaded; 



If you do not need all tne optional pnases, 
you can save SVA space by using your DiN?n 
procedure that snould have the following 
format: 



Condition 


Phase 


Size 
(oytes) 

L 


I/O forced to completion 
(during Close, for 
example) 


r 1 
IKQVPBF 


r 


700 


Share option ii used and 
(1) a control area must 
be split or (2) tne file 
is extended 


IKQVRBA 


1. 


100 


h new extent is needed 
when file is extended 


1K2VNBA 


3. 


700 


3t,NCB Tiacro is used by 
tne processing proqrain 


IKSVCtW 


2, 


400 


lMODCB, SaO'/^CYi, or TESTCB 
macro is used oy the 
processing program 


IKQVIMS 


9, 


600 


A non-contiqucus range 
of RBA.S is encountered 


IKQVEDX 


2, 


500 


lSfon-VSf\M file entry in 
VSAM catalog is 
processed 


IKQVDNr 




300 


A new voluiie must be 
mounted 


IK2VE0V 


1. 


100 


DASD file protection 
option is included in 
DOS/VS 


IKQVJIBS 


1. 


000 


VShM Close or Record 
Manageaient routines must 
update the VSAM catalog 


IKQVCLC 


2. 


500 


Device type must be 
determined 


IKQ\/DrPE 




600 


Alternate index struc- 
ture must be closed 


IKQVCLOV 




600 


Control blocks for 
alternate index struc- 
ture must be released 


IKQVCLOC 




500 


Build '^SAM resource pool 


IKQVBRP 


2, 


048 


Delete VSA.M resource 
pool 


IKQVDRB 




650 


SriOWCAT 


IKQVSCAI 


1. 


500 


VS?^M storage manager 
control block 
reallocation 


IKQVSTM 


2, 


000 



// SET SVA=(. . .K,0K) 
// SET SDL=CKEATE 

(non-VSA.M phase names) 

Ctne 7 VSA.yi root pnase names), SV?\ 

(the optional VSA.M phase names you will 

require) , SVA. 
/ + 
/+ 



The size of the SVA can be computed as 
follows: 

• 34 bytes for each SDL entry (the maximum 
number of entries is 934, which take up 
32K bytes) . 

• 2K bytes for the SVA directory. 

• 12K bytes if you want to load $JOBEXIr 
and $yiAINDIR into the SVA. 

• 227. 7K bytes for the VSAM root phases.* 

• rha total size of the optional VSAM 
phases you selected.* 

• Totalling the sizes of the VSAM root 
phases and of the optional phases does 
not give you tne exact size of tne SVA, 
as these pages are normally loaded on 
page boundaries, witn the exception of 
small phases, two or more of which fit a 
single page. 

Also, since the phases are entered in 
alphabetical sequence, what extra space 
is required depends on which optional 
phases you include in your procedure. If 
you include all of the optional phases, 
add lOK bytes to the total size of the 
root phases and the optional phases. For 
the same reasons, the size of tne SVA in 
procedure VSAMSVA is set to 302K bytes. 



ISAM Interface Program 



|. ^, ^ ^ 



I Total 

L 



32,798| 
: J 



^5Ri_I55^GE_LIBRARY 

r ■ T 1 

I E^^ses I 5 I 
I Blocks I 9 I 
L X J 

transient 
$$BOCISC 
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Phases 

IIPCLOSE 

IIPOPEN 

IIPPROC 

IIP^^MDTF 



RELOC^T^BLE_L.IbR^RY 

r T T 

I Modules I 7 I 

I Blocks I 44 I 

L X J 

Modules 

IIPBMROO 
IIPCLSOO 
IIPIIPOO 
IIPOPNOO 
IIPPRCPR 
IIPPRCMR 
IIPAMrOO 

Link-Edit_State2ents. 

// OPTION CATAL 

INCLUDE IIPIIPOO 
// EXEC LNKEDI 



Access Method Services 



CQRE_IM^GE_LIBRAkY 

r T T 

I Phases 1 81 | 

I Blocks I 496 I 

L ± J 

Phases 

IDCALOl 

IDCAMS 

IDCBIOl 

IDCCDA.L 

IDCCDBI 

IDCCDDE 

IDCCDDL 

IDCCDLC 

IDCCDLR 

IDCCDMP 

IDCCDPM 

IDCCDPR 

IDCCDRC 

IDCCDRM 

IDCCDRP 

IDCCDRS 

IDCCDV^Y 

IDCCDXP 

IDCDBOl 

IDCDB02 

IDCDEOl 

IDCDIOl 

IDCDI02 



IDCDI03 
IDCDI04 
IDCDI05 
IDCDI06 
IDCDI07 
IDCDI08 
IDCDI09 
IDCDIIO 
IDCDIll 
IDCDI12 
IDCDI13 
IDCDI14 
IDCDI15 
IDCDI20 
IDCDLOl 
IDCEX02 
IDCEX03 
IDCIO02 
IDCIO03 
IDCLCOl 
IDCLROl 
IDCMPOl 
IDCPMOl 
IDCPROl 
IDCRCOl 
IDCRIKT 
IDCRILr 
IDCRIOI 
IDCRMOl 
IDCRPOl 
IDCRSOl 
IDCSA04 
IDCSA05 
IDCrP04 

iDcrpos 

IDCrP06 

IDCrSALO 

IDCTSBIO 

IDCrSDEO 

IDCTSDLO 

IDCrSEXO 

IDCTSIOO 

locrsLco 

IDCTSLCl 
IDCrSLRO 
IDCTSLRl 
IDCrSMPO 
IDCTSPP6 
IDCrSPRO 
IDCTSRCO 
IDCrSRIO 
IDCTSRSO 
IDCrSTPO 
IDCTSTPl 

iDcrscjvo 

IDCTSXPO 

IDC7Y01 

IDCXPOl 



RELOCAr?^BLE LIBRARY 



r T 1 

I Number of Modules | Number of Blocks | 
y + ^ 

1 104 I 2,275 I 

L X J 



262 DOS/VS System Generation 



Modules 

IDCALOl 
IDCBIOI 
IDCCDA.L 
IDCCDBI 
IDCCDDE 
IDCCDDL 
IDCCDLC 
IDCCDLR 
IDC-DMP 
IDCCDPM 
IDCCDPR 
IDCCDRC 
IDCCDRM 
IDCCDRP 
IDCCDRS 
IDCCD\/y 
IDCCDXP 
IDCCMZl 
IDCCiyiZ2 
IDCDBOl 
IDCDB02 
IDCDEOl 

idc:de02 

IDCDE03 
IDCDIOl 
IDCDI02 
IDCDI03 
IDCDIOU 
IDCDI05 
IDCDI06 
IDCDI07 
IDCDI08 
IDCDI09 
IDCDIIO 
IDCDIll 
IDCDI12 
IDCDI13 
IDCDI14 
IDCDI15 
IDCDI20 
IDCDLOl 
IDCEXOl 
IDCEX02 
IDCEX03 
IDCIOOl 
IDCIO02 
IDCIO03 
IDCLCOl 
IDCLC02 
IDCLROl 
IDCLR02 
IDCMPOl 
IDCPMOl 
IDCPROl 
IDCRCOl 
IDCRC02 
IDCRC03 
IDCRC04 
IDCRIKT 
IDCRILT 
IDCRIOI 
IDCRI02 
IDCRI03 
IDCRMOl 
IDCRPOl 
IDCKSOl 



IDCRS02 

IDCRS03 

IDCRS04 

IDCRS05 

IDCRS06 

IDCRS07 

IDCSAOl 

IDCSA02 

IDCSA03 

IDCSA04 

IDCSA05 

IDCSA08 

IDCTPOl 

IDCTPOU 

IDCTP05 

IDCTP06 

IDCTSALO 

IDCTSBIO 

IDCTSDEO 

IDCTSDLO 

IDCTSEXO 

IDCTSIOO 

IDCTSLCO 

IDCTSLCl 

IDCTSLRO 

IDCTSLRl 

IDCTSiyiPO 

IDCTSPRO 

IDCTSRCO 

IDCTSRIO 

IDCTSRSO 

IDCTSTPO 

IDCTSTPl 

IDCTSTP6 

IDCTSUVO 

IDCTSXPO 

IDCVYOl 

IDCXPOl 

Link-E dit S tatements 

// OPTION CATAL 

INCLUDE IDCCMZl 

// EXEC LNKEDT 

// OPTION CATAL 

INCLUDE IDCCMZ2 

// EXEC LNKEDT 



STORAGE REQUIREMENTS 
Real S tora ge for VSAM 



To avoid excessive paging, an amount of 
real storage should be available in the 
page pool which approximately matches the 
VSAM working set. 

The working set requirements for 
processing a VSAM file are as follows: 

• For frequently used modules of VSAM 
record management (phase IKQVRM) : 11 
pages per partition. During loading or 
extension of a file, or whenever many 
control interval splits take place, up 
to 13 pages may be needed. 
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For (external and internal) control 
blocks: 1 page (miniinum) per file. 



• For tne channel program area usea JDy 
VSAM: 1 page per file. 



VSAM buffers - an amount of storage tnat 
depends on the control interval size and 
the number of Duffers used for the file. 



Minimum Working Se t for a Single File 



Provided all tne conditions listed in 
Figure 17-1 are met, the minimum working 
set size for a single VSAM key-sequenced, 
or entry-sequenced , or relative-record file 
can be calculated as follows: 

- IKQVRM 11 pages* 

Control blocks 1 page 

Channel program area _1 .page 

= 13 pages 

+ Buffers 

* or 13 pages when the file is loaded or 

extended. 



Tne conditions for using a minimum 
working set are: 

The file must not nave key ranges 
associated with it. 

The file m»:st not nave more than one 
extent for data. 

Tne file must not nave 
SHAREOPTlOi.^S(4) . The lengtn of the 
key field is assumed to be four bytes. 

The file must not have more than one 
extent for the sequence set and for 
the higher-level index. 

The number of data buffers must be 2; 
the number of index buffers must oe 1 
if the file is a key-sequenced file. 

Tne ACB and RPL must be created via 
GENCB, leaving the space allocation up| 
to VSAM and in the sequence 

GENCB ACB 
GENCB RPL 

The file must be opened for one string, 
only (STRNC=1). 

L J 

Figure 17-1. Minimum Working Set 
Conditions 



For eacn additional file in the partition 
the following has to be added to the 
mini[na:n working set size: 



1 page for control blocks (nniminum) 
1 page for the channel program area 
n pages for buffers 



/^orkini_Set_f or_Alterna^e_Index_Proce3sinc[ 

If an alternate index is processed as an 
end-usa object, that is, without its 
related base cluster, it is treated as a 
key-sequenced file and, therefore, has the 
sanae working set requirements as a 
ksy-saquenced file. 

If a path is establisned between an 
alternate index and its oase cluster, the 
working set requirements for processing tne 
base cluster via this alternate-index path 
(path entry) are as follows: 

• For frequently used modules of VSAXI 
record management (phase IKQVR.Vl) : lU 
pages per partition. 

• For external and internal blocks: 

1 page (minimum) for the path entr/ 

2 page (minimum) for the base cluster 
1 page (minimum) for each alternate 

index in the upgrade set in 
addition to the path entry. 

• For the channel program areas: 

1 page for the path entr/ 
1 page for the base cluster 
1 page for the upgrade set 

• VSAM buffers for: 



the base cluster 
the alternate index pa 
for an UPDATE path onl 
a minimum of two data 
index buffer for any a 
index(es) in the upgra 
addition to the altern 
the path entry) . Note 
alternate indexes of a 
(except that of the pa 
a common set of buffer 
that of the largest bu 
specified. 



tn (path entry) 

y- 

buffers and one 
Iternate 
de set (in 
ate index of 

that all the 
n upgrade set 
th entry) share 
s whose size is 
f f ers 



Note: For a NOUPDATE patn, the alternate 
indexes wnich are members of the upgrade 
sat are not opened. Therefore, only space 
for the path entry and tne base cluster nas 
to be provided. If a base cluster is not 
processed via a path, but has an upgrade 
set assigned to it, space for the base 
cluster itself and for tne upgrade set 
members nas to be provided. 
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ii2EJSili3_Set_for_VSAM_Files_Sharinc[_a 
Resource Pool 

VSAM files with MACRF(LSr) in tue ACB have 
the following working set requirements: 

• For frequently used modules of VSAM 
record management (phase lK2VR!yi) : 12 
pages per partition. 

• For external and internal control 
blocks: 1 page (minimum) per file. 

• For the VSAiVl resource pool: an amount 
of storage that depends on the 
parameters specified in the BLDv/RP 
macro. 

£2£_^ccess__M^tnod_Ser vices: To operate 
efficiently, tne Access Method Services 
working set requires approximately 64K 
bytes of real storage. 



Virtual Storage 

For _ysi\^d: VSAiyi routines reside in pageable 
virtual storage. The recommended 
allocation is 302K bytes in any partition 
in which VSAM will execute, or 302K bytes 
in the SVA. Tnis oasic allocation also 
covers any space requirements for ISAM 
Interface Program (IIP) phases to oe loaded 
when a 7SAM file is processed Dy an ISAM 
program. (For a more precise storage 
requirement calculation use the taole as 
shovm in the section. "Loading VSAM and RPS 
Phases Into the SVA" , ) 

If VSAM runs in the SVA, a certain 
amount of storage must still De allocated 
to VSAM in the partition for buffers and 
control blocks. Tnis amount can be 
approximated as follows: 

1. Compute for eacn file as a minimum: 

2 X the data control interval size; 

1 X the index control interval size 
(for a key-sequenced file or 
alternate index) ; 

2K bytes for control blocks. 

2. Total the results and add a oasic 
requirement of 30K bytes. 



Note: Control interval size and tne 
minimum amount of duffer space for a file 
are specified when the file is defined. 
you can allocate more than the minimum 



amount of buffer space wnen tne file id 
processed. Refer to D03/VS Supervisor and 
iZ0_Ma2£2§ fo^^ the ACB macro, and to DOS/VS 
§ZStem_Control_Statements for tne DLBL job 
control statement. 

For Access Meth od Services: In addition to 
the 302K byte basic allocation for VSAM (or 
302K bytes in the SVA), Access Method 
Services requires up to 450K bytes of 
virtual storage in the partition in wnicn 
it is to run. Unlike VSAM phases, the 
Access Method Services modules cannot oe 
loaded into the SVA. 



Tne root modules, comprising 26K bytes, 
are loaded into the virtual address area 
when the user wants to perform any of tne 
following functions. In addition to the 
root modules, the remaining Access Metnoa 
Services substructure modules plus their 
required dynamic work areas are required to 
perform any function. Tne total virtual 
storage requirement for the substructure 
(including the root modules) is 114K. In 
addition, you must provide virtual storage 
for tne specific Access Method Services 
commands to be processed. If you know wnat 
your functional mix is in the job stream, 
you can calculate a more precise virtual 
size from the taPle below. 



Function 



Size (oytes) 





ALTER 




23, 


000 






BLDINDEX 




24 


000* 






DEFINE 




52. 


000 






DELETE 




10 


000 






EXPORT 




23 


000 






EXPORTRA 




45 


000** 






IMPORT 




29, 


000 






IMPORTRA 




33 


000 






LISTCAT 




42 


000 






LISTCRA 




39, 


000 






PRINT 




8 


000 






REPRO 




17 


000 






RESETCAT 




124, 


000 






VERIFY 


L 


2, 


000 


J 




r 






1 




Total 


1 


471 


000 


1 


1 .. 













+ This does not include the storage 

required for sorting records. Refer to 
DOS/ V3_ Ac cess Method Services User's 
Guiae, 3C33-53 82. 

*+Tnis does not include the 255,000 bytes 
required for the EXPORTRA command taole. 
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:ORE I^4?^3E LIBRARY 







i 


Phase 


1 


Blocks 


1 

1 

1 


Assembler 


T " 

1 
1 


19 


" T ■ 

1 
1 . 


122 


r 

1 

1 


ESERV 


t 

! 

J. - 


7 


t 
1 


U1 



Pnases 

Assembler 

ASSECA 

ASSEDA 

ASSEEA 

ASSEFA 

ASSEGA 

ASSEHA 

ASSEIA 

ASSEJA 

ASSEKA 

ASSELA 

ASSEMA 

ASSEMBLY 

ASSEOA 

ASSEQA 

ASSERA 

ASSERB 

ASSERC 

ASSESA 

ASSETA 



ESERV 

ESERV 

ESERVB 

ESERVD 

ESERVE 

ESERVF 

ESERV3 

ESERVI 



RELOCAIABLE_LIBRARY 

r T T 1 

I I Modules I Blocks | 
|. + 4. 4 

I Assembler | 38 j 609 t 
j. ^ 1 4 

1 ESERV I 10 ] 218 I 

L J X J 

Modules 

Assembler 

IPKAA 
IPKAB 
IPKAC 
IPKAD 
IPKAE 
IPKAF 



IPKAG 

IPKAH 

IPKAI 

IPKAJ 

IPKBA 

IPKCA 

IPKCB 

IPKCC 

IPKCD 

IPKDA 

IPKDB 

IPKEA 

IPKFA 

IPK3A 

IPKHA 

IPKIA 

IPKIC 

IPKJA 

IPKKA 

IPKLA 

IPKLINK 

IPKWA 

IPKtJA 

IPKOA 

IPKPA 

IPK2A 

IPKRA 

IPKRB 

IPKRC 

IPKSA 

IPKSB 

IPKTA 



Link-Edit Statements 



INCLUDE IPKLINK 
/* 
// EXEC LNKEOr 

ESERV 

IPKESERV 

IPKVA 

IPKVB 

IPKVD 

IPKVE 

IPKVF 

IPKVG 

IPKVI 

IPKVK 

IPKVM 



Link-Edit statements 



INCLUDE IPKESERV 
/* 
// EXEC LNKEDT 



Note: /Jnen link-editing tne ESERV program, 
tne Link-Edit iXiap will contain one 
unresolved address constant (IPKAB103). 
Tnis is a symbol used in tne Assemoler 
only. 
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SOURCE_Sr^TEMENT_LIBR^RY 

r ■ T 1 

I NuTiber of | Source Statement j 
I Macros I Library Blocks j 

j. ^ ^ 

I 2 1 44 I 

L J. J 

Macros 

E.IVP?ISLC 
E.IVPASLS 

ii2£lS_£klss 

To determine the number of bytes required 
for tbe assembler work files, use the 
folloirfing formulas: 

SXSOOl: /Whichever is the larger of 

60(ITXr+SM) 

and 

60(SM+LM) 

SYS0Q2; Whichever is the larger of 

60(ITXr+SM) 

and 

40.ETXr 



SXS003: If option l^OXREF is in effect: 

eo.DTxr 

If option XREF is in effect: 

loo.orxr 

SYSLNK: IS.ETXI 

where 

ITXr = Total number of statements on 
SYSIPT. 

OTXT = Total number of statements on 
SYSLST. 

SM = Number of statements in source macro 
definitions. 

ETXT = OTXT minus SM minus number of 
comment statements. 

LM = Number of statements in library 
macro definitions called by the 
program. 



The approximate number of tracks can be 
computed by dividing the number of oytes by 
6000 for a 2314/2319 file, by 12000 for a 
3330 file, and by 7000 for a 3340 file. 



270 DOS/VS System Generation 



Module 19: OLTEP - 5745-SC-OLT 




Module 19: OLTEP — 5745-SC-OLr 271 



PARnnON SIZE 



B-rraasients 



The prograa requires a background real 
allocation of 16K bytes, 20K bytes with 
RETAIN active. 



Q2RE_I^A.3E_LIBRAR^ 

r T 1 

I Phases | Blocks | 
, 1 1 ^ 

I I OLIEP I 48 I 91 I 
^ 1 + ^ 

I B-rransients | 2 | 2 | 
L X X. J 

Phases 

IJZ?^CEDM 
IJZACOMP 
IJZ^CONV 
IJZA.DO00 
IJZA.DO02 
IJZADO03 
IJZAD007 
IJZADOIO 
IJZADOll 
IJZ?^D016 
IJZAD021 
IJZAD022 
IJZA.D024 
IJZ?^D026 
IJZA.D028 
IJZAD031 
IJZAD032 
IJZA.D033 
IJZAD035 
IJZAD036 
IJZSlD037 
IJZAD039 
IJZADO40 
IJZAD041 
IJZAD042 
IJZAD043 
IJZAD044 
IJZ?^D045 
IJZAD047 
IJZAD049 
IJZAD052 
IJZAD056 
IJZAD057 
IJZAD062 
IJZAD064 
IJZADO70 
IJZAD071 
IJZAD076 
IJZAD077 
IJZAD078 
IJZAD098 
IJZADOAA 
IJZADOAB 
IJZADOAJ 
IJZADOLD 
UZADOLI 
IJZAOPUr 
IJZARAIA 



$$BOLrEP 
$$BrOLTP 



Note; rne B-transients are cataloged into 
the core image library along with tne OLTEP 
component. 



:ONFI3URAriON DATA SET 



A CDS (Configuration Data Set) is required 
in the core image library for eacn device 
on the system and one for the CPU. This is 
tne for:nula for calculating the Dlock 
requirements : 



6 



ONLINE TESTS (OLTS) 



library dIocks 



The number of core image library blocks 
required for the OLTs (Online Tests) is 
dependent on the number of types of devices 
on the system, and the number and size of 
the OLTs needed to test these devices. 
This information can be found in the 
writeup that accompanies the OLTs. 



GENERATING TdE OLT/CDS LIBRARY 



The FID (PrograTi Information Department) 
supplies a master tape or disk (if tne 
system has no tape drives) to tne Customer 
Engineer. This tape contains OLTSLP, SOSP, 
and OLTs. The EDITDOS function of SOSP 
(Standalone service and Online Test 
Support) is used to create OLT and CDS 
input for the DOS/VS Linkage Editor. This 
input can be created on disk or tape. 



The Job Control statements required to 
link the OLTs and CDSs into the core image 
library are as follows: 



Tape Input 



// JOB 



XXXXXXXX 



assign work files for the Linkage Editor, 
if necessary 

// ASSGN SYSIN,X'CUU' 

where cuu is tne address of the tape drive. 
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Dis)c_InBut 

// JOB XXXXXXXX 

assign work files for the Linkage Editor, 

if necessary 

// DLBL IJSYSIN, 'EDITPACK' 
// A.SS3t^ SYSIt^,X' CUU' 

itftiere cuu is the address of the disk drive. 

The OLTs and 2DSs are required to run tests 
under OLTEP. The customer engineer will 
create the library using the specified 
procedure. This procedure is also used to 
add new OLTs and/or CDSs when devices are 
added to the systeni. 

RELOC^r^BI;E_LIBRARX 

P J ^ 

1 Modules I Blocks | 

[. 1 ^ 

I 50 1 mo 1 

U X J 

Modules 

IJZABOOK 
IJZACEOyi 
IJZACOMP 
IJZAC0N7 
IJZADOOO 
IJZADO02 
IJZADO03 
IJZADO07 
IJZADOIO 
IJZADOll 
IJZAD016 
IJZAD021 
IJZAD022 
IJZAD02a 
IJZAD025 



IJZAD028 
IJZAD031 
IJZAD032 
IJZAD033 
IJZAD035 
IJZAD036 
IJZAD037 
IJZAD039 
IJZAD040 
IJZADOm 
IJZAD042 
IJZAD043 
IJZADOtm 
IJZAD0M5 
IJZAD047 
IJZAD049 
IJZAD052 
IJZAD056 
IJZAD057 
IJZAD062 
IJZAD064 
IJZADO70 
IJZAD071 
IJZAD076 
IJZAD077 
IJZAD078 
IJZADOAA 
IJZADOAB 
IJZADOAJ 
IJZADOLD 
IJZADOLT 
IJZAOLTP 
IJZAOPUT 
IJZARATA 
IJZATOLT 



Link-Edit_S tat eTients 

INCLUDE IJZABOOK 
// EXEC LNKEDT 

Delete Statem en ts 

DELETR IJZ.ALL 
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Module Outline 



core image library , . 277 

BTAM online terminal test 

pattern phase identification 277 

BTAM transients 278 

relocatable library 278 

modules 279 

concurrent CLTEP 279 

channel program 279 

WTTA subroutine 279 

local 3270 table of command 

codes 2 80 

channel program modules for BSC 280 

ESC tables of special characters 280 

translation tables 2 80 

delete statements 281 

source statement library 281 

macros 282 

storage requirements 283 

DTFBT (define tne file: BTAM) 28? 

table requirements 283 

DTFBTND (-define tne file 

end: BTAM) 285 

DFTRMLST (define the terminal 

list: BTAM) 285 

BTMOD (BTAM loqic module) 286 

BTAM data event control Dlock 

table requirements 2 86 

SCANREQ DECB requirements ,.. 286 
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Module Index 



B 

BSC table of special characters /80 

BTMOD (BTAM logic modules), size 
of z8b 



L 

library book (macro) names 282 

library book (macro), number of 2 81 

local 3270 table of command codes ^79 



M 



channel program modules (for 

start/stop) ^7y 

channel program modules for BSC zbO 

concurrent OLTEP z7i* 

core image library 277 



macros, IBM-supplied ^8^ 

module names 279 

modules, number of 278 



D 

DACA (display alphameric control 

area) ^80 

data event control block /b6 

delete statements ^81 

DFTRMLST (define the terminal list 

BTAM) 2 85 

DFTRMLST (table requirements, 
BTAM) 

AUTOLST/AUTOWLST , ^ bt> 

DIALST 2 85 

IDLST 285 

OPENLST 285 

SSLAST/SSAWLST z8d 

WRAPLST ^65 

WTTALST ^8b 

DTFBT (define the file BTAM) , size 

of table 283 

DTFBT table requirements formula 305, ^g3 

DTFBTND (define the file end BTAM) ^35 



I 



online terminal test pattern phase 

identification 277 

online terminal test patterns 

phases z77 

transients 277 



phase names 277 

phases, number of /77 



relocatable liorary 27( 

relocatable liorary blocks zH 



transients, BTANi 278 

translation tables z80 



IOCS module sizes 

BSC ^80 

Start/stop 21^ 

translate tables.. 280 



W 

WTTA subroutine 279 



276 DOS/VS System Generation 



CORE IVIA3E LIBRAR!^ 



j Phases ] 



1 1 



Blocks I 

^ 



BTBlVI Online | | 
rerminal rest ] | 
Patterns: | 52 | 52 
Transients j 8 | 14 
1 1 

BT^yi Transient | ! 

Routines j 21 | 23 

(other than j | 

Test Patterns) I I 



L X J J 



BTAiyi Online Ternninal Test Pattern Phase xdeatif ication 



Phase Names 



Test Patterns for Online Terminal Tests 



IJLBOT02 
IJLBOT03 
IJLBOT04 
IJLBOr05 
IJLBOTOe 
IJLBOT07 
IJLBOrOS 
IJLBOT09 
IJLBOnO 
IJLBOTll 
IJLB0rl2 
IJLBOTIB 
IJLB0ri4 
IJL30T15 
IJLB0ri6 
IJLBOTl? 
IJLB0T18 
IJLB0ri9 
IJLBOT20 
IJLB0T21 
IJLBOT22 
IJLBOT23 
IJLB0r2U 
IJLBOT25 
IJLBOT26 
IJLBOr27 
IJLBOr28 
IJLBOr29 
IJLBOT30 
IJLB0T31 
IJLBOr32 
IJLBOT33 
IJLBOr34 
IJLT2A.LC 
IJLT2R0T 
IJLT2TLT 
IJLT2TW3 
lJLT3hL,C 
IJLT3R0T 
IJLT3SLA. 
IJLT3TLr 
IJLT3r^S 
IJLTS^LC 
IJLTSROr 
IJLT5SLA. 



Transparent EBCDIC Message 

USASCII Transparencv' .Message 

NorTial EBCDIC Message 

Nomal US^lSCII .Viessage 

Mpnameric USASCII Message 

aSASCII Printer Message 

aSASCII Punch Message 

TRANSCODE Printer Message 

TRANSCODE Punch Message 

TRANSCODE Multipoint Message 

EBCDIC Printer Message 

EBCDIC Punch Message 

EBCDIC Alpfiameric Message 

EBCDIC Weak Pattern Message for Switched Line 

EBCDIC i^eak Pattern Message for Leased Line 

TRANSCODE iJeak Pattern Message for Switched Line 

TRANSCODE /Jeak Pattern Message for Leased Line 

EBCDIC Weak Pattern for OLE SiTN Insertion 

EBCDIC 80-Character Transparent Message 

EBCDIC 120-Character Transparent Message 

EBCDIC 144-Character Transparent Message 

3270 Basic EBCDIC Test Pattern 

3270 Model 1 Align EBCDIC Test Pattern 

3270 Model 2 Align EBCDIC Test Pattern 

3270 Orders EBCDIC Test Pattern 

3270 Universal Character Set Test Pattern 

3270 NL/EOM Printer EBCDIC Test Pattern 

3270 Basic ASCII Test Pattern 

3270 Model 1 Align ASCII Test Pattern 

3270 Model 2 Align ASCII Test Pattern 

3270 Orders ASCII Test Pattern 

3270 Universal cnaracter Set Test Pattern 

3270 NL/EOM Printer ASCII Test Pattern 

All Character Test for IBM 2848 

Rotate Test for IBM 2848 

Tilt Test for IBM 2848 

Twist Test for IBM 2848 

All Character Test for IBM 1030 

Rotate Test for IBM 1030 

Analyzer Test for IBM 1030 (SELECTRIC) 

Tilt Test for IBM 1030 

Twist Test for IBM 1030 

All Character Test for IBM 1050 or 2740 

Rotate Test for IBM 1050 or 2740 

SELECTRIC Analyzer Test for IBM 1050 or 2740 
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P!Ei^§.s„Ei^5§§ Test _ Patterns, .for _0[iline_rerminal Tests 

ULTSIL-r rilt Test for IBM 1050 or 2740 

IJLT5TWS Twist Test for IBM 1050 or 2740 

IJLT6A.LC all Character Test for IBM 1060 

IJLT6R0r Rotate Test for IBM 1060 

IJLr6SL/\ SELECTRIC Analyzer Test for IBM 1060 

IJLT6TLr Tilt Test for IBM 1060 

IJLT6T/JB Twist Test for IBM 1060 



Mh!A Transients 



$$A.BERP1 Control handler for BTAM special aiessage writer and error statistics 

recorder 

$$A.BERP2 BSC Online test .-nessage writer 

$$?\BERP3 Console special message writer 

$$?\BERP4 Remote 3270 status/sense error recorder 

$$AB2RP5 Error recovery .iiessage writer, phase 1 

$$A.BERP6 Error recovery Tiessage writer, phase 2 

$$A.BERP7 Error recovery naessage writer, pnase 3 

$$ABERP8 RMSR record builder 

$$?\BERP9 Free areas from real storage 

$$BBT3SC OLTEP device assignment 

$$BBT3SI OLTEP device assignment initiation 

$$BCTC01 CLOSE routine 

$$BETPRT Error tnreshold message 

$$BHDRCK Terminal test request validation and comparison 

$$BLEPRT Line error print routine 

$$BLOPEISi OPEN routine 

$$BOTC01 OPEN routine 

$$BOrC02 OPEN for local devices routine 

$$BOrc03 OPEN logic processor 

$$B0TC1A OPEN logic module, phase 3, for non-local devices 

$$BRESPL Reset Polling Lines 

$$BTCNCL Cancel routine 

$$BTN1EB3 Terminal test request - IBM 1030 Manual Entry and Badge Reader 

$$BT1030 Terminal test module - IBM 1030 

$$BT1050 Terminal test module - IBM 1050 

$$BT1060 Terminal test module - IBM 1060 

$$BT2260 Terminal test module - IBM 2260 

$$Br2740 Terminal test module - IBM 2740 

$$BT2848 Terminal test module - IBM 2848 

RELOCarA.BLE_LIBRARX 

r T 1 

1 Modules I Blocks ) 

j. 1 ^ 

I 65 I 179 I 

L X J 
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Modules 



r T 

Module I 

Wame j Description 

-L 



T 1 

I B/tes of 

I Storage 

-X 



:ONCaRRELMT OLTEP 



T - 


^_ 




BT3270SCI concurrent OLTEP Setup 


1 


2535 


IJLZSCAN] 


1 


5796 


i 


i_ 





CHA^Nl^EL PROGRAM 



(For St 



art/stop, 

-T 

I WTTOl 
I IBM 7770 
[IBM 1030 
I IBM 1030 
I IBM 1060 
I IBM 1060 
I IBM 2 848 
|AT&r 83B 
I Western 
I Table Gs 
1 IBM 1050 
I IBM 1050 
I IBM 1050 
I IBM 2740 
|IBM 2740 
I IBM 2740 
I IBM 2740 
I IBM 2740 
jlBM 2740 
I IBM 2740 
|IBM 2740 
I IBM 2740 
I IBM 2740 
I IBM 2740 
I IBM 2740 
|TWX 33 
I IBM 7772 



the modules include a taole of special characters.) 



IJLOEZ 
IJLOOir 
IJLOIJ 
IJLOIZ 
IJL02J 
IJL02Z 
IJL03Z 
IJL04Z 
IJL05Z 
IJL06Z 
IJL07J 
IJL07ir 
IJL07Z 
IJL08H 
IJL08M 
IJL08P 
IJL08Q 
IJL08R 
IJL08U 
IJL08X 
IJLOSiT 
IJL08Z 
IJL081 
IJL082 
IJL089 
IJL09^ 
IJLIOY 



(Auto Poll) 
(Auto Poll) 

Re:tiote 
3 

Union 115A 
neration for 2260 Local Cfiannel Program 

Nonswitctied (Auto Poll) 

Switched 

Nonswitcned 

with Station Control (Auto Poll) 

witn Dial, Transmit Control, and Checking 

with Station Control and Checking 

with Dial and Checking 

with Checking 

with Dial and Transmit Control 

with Station Control 

with Dial 

Basic 

and OIU with Dial and Ctiecking 

and OIU with Checking 

witn Station Control and Checking (Auto Poll) 



124 

76 

187 

139 

175 

127 

209 

78 

72 

16 

132 

202 

124 

97 

176 

132 

172 

141 

122 

92 

114 

93 

246 

181 

145 

110 

76 



WTTA SUBROUTINE 



IJLWTZ I WTTA Subroutines 

J. 



1223 



LOCAL 3270 TABLE OF COMMAND CODES 



^ ^ 

lULOHZ I3277L table of command 'codes 
L X 



30 
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r T 

Module I 

Name | Description 

X 



■y 1 

1 Bytes of 

I Storage 

-X 



CHANNEL PROGRAM MODULES FOR BSC 

rtie following relocatable n^iodules are BSC channel program modules for switctied 
lines using ID verification (CPU-to-CPJ) . Tfie correspondence between 
relocatable Tiodule name and the codes that appear in the FEATURE operand 
sublist in the DTFBT macro instruction is indicated. 



IJLOBiT 
IJLOBZ 
IJLODif 
IJLODZ 
IJLIBZ 
IJL2DZ 
IJLEDir3 



For switched lines 

For nonswitcned lines 

IBM 2780 switched point to point 

IBM 2780 nonswitched point to point 

BSC Multipoint Lines 

IBM 2780 Multipoint for TRA^JSCUDE 

Logic, IP EDIT Macro 



415 
281 
212 
148 
253 
136 
2090 



TABLES OF SPECIAL CHARACTERS 



IJLA3C I In ASCII for BSC 

IJLEBD t In EBCDIC for BSC 

IJLTCD I In 6-bit TRANSCODE for BSC 

X. 



85 
85 
69 



TRANSLATION TABLES 



IJLRASA I For USASCII to EBCDIC for BCS | 256 

IJLRCTW I For ITA2 to EBCDIC (World Trade Teletype) j 256 

IJLRCTl I From BAUDOT to EBCDIC | 256 

IJLRCr2 j From TWX to EBCDIC | 256 

IJLRCT3 I From ZSC3 to EBCDIC (World Trade Teletype) | 256 

IJLRC30 I From 1080 to EBCDIC | 256 

IJLRC4D I From 2740 to EBCDIC (lowercase) | 256 

IJLRC50 I From 1050 to EBCDIC (lowercase) | 256 

IJLRC60 IFrom 1060 to EBCDIC I 256 

IJLRC80 IFrom 6-bit TRANSCODE to EBCDIC | 256 

IJLRF40 IFrom 2740 to EBCDIC (uppercase) j 256 

IJLRF50 i From 1050 to EBCDIC (uppercase) | 256 

IJLR3CI IFrom USASCII to EBCDIC with 2848 attached to 2701 via IBM Terminal | 256 

I Control Type III j 

IJLSASA IFrom EBCDIC to USASCII for BSC 1 256 

IJLSCTW [From EBCDIC to ITA2 (World Trade Teletype) | 256 

IJLSCTl j From EBCDIC to BAUDOT | 256 

IJLSCT2 IFrom EBCDIC to TWX | 256 

IJLSCT3 JFrom EBCDIC to ZSC3 (World Trade Teletype) | 256 

IJLSD30 I From EBCDIC to 1030 | 256 

IJLSO40 IFrom EBCDIC to 2740 | 256 

IJLSD50 I From EBCDIC to 1050 | 256 

IJLSD60 I From EBCDIC to 1060 | 256 

IJLSD80 [From EBCDIC to 6-bit TRANSCODE | 256 

IJLSSCI IFrom EBCDIC to USASCII with 2848 attached to 2701 via IBM Terminal | 256 

1 Control Type III j 
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Q^lete^Statements 

To aelets the BTAM phases from the core image library, the BTSlM modules from the 
relocatable library, and the BTAM books irom the source statement liorary, you must 
supply the DELET statement for the appropriate library and the name of the phase, module, 
or book to be deleted. For example: 

// JOB DELETC 
// EXEC MAINT 

DELErC $$BC:T01,$$BETPRr,etC. 

DELETC IJLr2ALC,IJLT2ROT,etc. 

DELETR IJLOOY,IJLOlZ,IJL02Z,etc. 

DELETS E. CONTROL, E.LERB, etc 
/& 

To delete both BTft.M and QTAM from the core image, relocatable and source statement 
libraries, the DELET statement for the appropriate library and tne folloiving entries must 
be made: For the core image transients, you must supply the DELETC statement witfi a 
separate entry for each transient (QTA.M and BTAM) to be deleted. For the core image 
phase names, enter the delete statement as follows: 

DELETC $$BCTC01,$$BOOO03,$$BETPRT,etC. 
DELETC IJLB.ALL 
DELETC IJLT.ALL 

To delete both BT^M and QThyi from the relocatable liorary, enter: 

DELETR IJL.ALL 

To delete the BTAM and QThM books from the source statement library, enter the DELEIS 
statement with a separate entry for eacn book to be deleted. Tne following example shows 
the required delete statements and type of entries to be made in those cards: 

// JOB DELETE 
// EXEC MAINT 

DELETS E. CONTROL, E.CANCELM, etc. 
/& 

SOURCE STATEMENT LIBR ARY 

J. ^ ^ 

I Macros 1 Blocks | 

1. + ^ 

i 65 ! 8,620 I 

L X J 
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Macros 



I Storage Bytes | 
+ -r ^ 













Storage Bytes 














Basic 


j For Variables 
J. 








-— 


~ 





T 


E. AS 














E.?VS2rR 














E. ASLISr 














E.BTBDNLr 


(inner 


macro 


in 


BTMOD) 






E.BTBrEIH 


(inner 


macro 


in 


BTMOD) 






E.BTBTFIX 


(inner 


macro 


in 


BTMOD) 






E-BTBrFREE 


(inner 


macro 


in 


BTMOD) 






E-BTBTROD 


(inner 


macro 


in 


BTMOD) 






E.BTBIRSCH 














E.BTCEJdODE 


(inner 


macro 


in 


BTMOD) 






E.BTCKID 


(inner 


macro 


in 


BTMOD) 






E.BTCONSr 














E.BTCSE 


(inner 


macro 


in 


BTMOD) 






E.BTCTCJPr 


(inner 


macro 


in 


BTMOD) 






E.BT«OD 














e.BT^4DDIHl 


(inner 


macro 


in 


BTMOD) 






E.Br«0DIH2 


(inner 


macro 


in 


BTMOD) 






E.BTNCKID 


(inner 


macro 


in 


BTMOD) 






E.BTOLrCMP 














E.BTOLriH 


(inner 


macro 


in 


BTMOD) 






E.BTONLAP 


(inner 


macro 


in 


BTMOD) 






E.BTONLO?^ 


(inner 


macro 


in 


BTMOD) 






E.BTRD 














E.BTRLBF 


(inner 


macro 


in 


BTMOD) 






E.BrRQBF 


(inner 


macro 


in 


BTMOD) 






E.BTRWC 














E.BrrRANS 


(inner 


macro 


in 


BTMOD) 






E.BTviAlT 














E.CHSWrRiT 










20 (Start-stop) 

72 (BCS) 

20 (Start-stop Auto Poll) 

22 (2260 Local) 


1 +6 (wote 2) 

1+72 (iMOte 2) 
1 +4 (Note 2) 


E.CONFIGUR 














E.CONrROL 










20 


1+38 (Note 2) 


E.CTR3R0UP 














E.CTRLIST 














E.CTRSCHED 














E.DECJLIST 














E.DISP3UID 














E.DFPR^ILST 














E.DTFBr 














E.GDa?^S 














E.GOaLIST 














E.GDaiRANS 














E.LERB 










20 




E.LERPRT 










14 


1+8 (Wote 2) 


E.LOPEN 










8 


1+2 (Note 2) 


E.MAPP0B2 (Note 5) 












E.ONLrST 














E.PARAMNUM 














E.P?^RMLIST 














E.RELBUF 










14 


1+4 (Note 3) 


E.RE2BUF 










12 


1+8 (Note 4) 


E.RESETPL 










12 


1+4 (Note 2) 


E.RMSRTAB 















L ± J. J 
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storage Bytes 



l. 

L 


+- 

— - X 


Basic 


Storaqe B^tes 


T 

iFor Variables 
i 


r 


t 






T 


|Z.SAyiP327L 










|Z.SA^4P327R 










1 E.SC?VMREQ 










1 E.SDRrAB 










1 E.STEND 










lE.rGROJP 










lE.TPEDir 










lE.TRLISr 










|E.rRA.NSL?^T 










lE.rRNSLATE 




26 




1+16 (L^lote 2) 


1 E.TRSRCr^ 




256 






|E.TRSRCr3 




2^6 






1 E.TRSSCrW 




256 






lE.TRSSCrS 




256 






1 E.TvihlT 




24 




1+20 (Note U) 



L ± X J 

Notes : 

1. n=namber of different operands coded. 

2. No operands coded in register notation. 

3. First operand not coded in register notation. 

4. All possible operands not coded in register notation. 

5. Ttiis is a supervisor generation macro that is also used Dy BTAfd. 

Storage Requirements 

QIf^Br_lDEFINE_THE_FILEj .BTAM), 

I^BLE_RE2UIREMENTS 

Size = 64 + N (40 + 8x) + BLJFCB + BUFNO (BUFL + f) + y + z 
(+ 32N for BSC only) 

where: 

N = number of lines in the line group (or, for a local 2260 and local 3270*+, the 

number of devices attached to the control unit) 
X = number of CCrfs in the largest channel program available for the device, given 

in Figure 20-1 
♦BUFCB = 8 if a buffer pool is used 

= if a buffer is not used 
♦BUFWO = number of buffers in tne pool 
♦BQFL = length of each buffer 

f = number of bytes required to extend each buffer to a multiple of 8 
y = size of the model channel program table for the line group, given in Figure 

20-1. If two or more DTFBTs use the same model channel program and are 

linkage edited together, include the value only once. 
Z = Size of the table of special characters given in Figure 20-1. For BSC only, 

if two or more DTFBTs use the same transmission code, include the value only 

once. 

* If the buffer pool is shared by two or more DTFBTs, include the value only once. 
*♦ For a local 3270, at least one DTFBT is required for each control unit. 
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Device 

1030 

1050NS 

1050S 

1060 

2260L 

2260R 

2740 

2740c: 

2740DC0 

2740C:0 

2740D 

2740DC 

2740Dr 

2740DrC 

2740S 

2740SC 

3277L 

115A 

83B3 

r«X 33/35 

WTTA 

BSCl; also 1130, 2780, and 2020 

nonswitchea point to point 
BSC2; also 1130, 2780, and 2020 

switched point to point 
BSC3; also 1130, 2780, 2020, and 

2972 multipoint. 
2780 transcode, nonswitciied point 

to point. 
2780 transcode, switched point 

to point 
2780 multipoint 



without 

start/stop 

7 
7 
11 
6 
1 
7 
4 
4 



with 



A-uto Poll 

9 
9 

9 



+- 



84 

68 
136 

80 
Not applicable 
136 

24 

68 
207 
155 

52 
100 

68 
116 

48 

84 

28 

36 

40 

56 

52 
248 

372 

252 

111 

175 

123 



23 

16 

34 

15 
Not applicable 

20 

21 

33 

30 

24 

18 

32 

22 

36 

12 

24 
Not applicable 
4 
6 

18 

36 

53 

53 
53 
53 
53 
53 



Figure 20-1. BTAM — Parameters for DTFBT Table Requirements Formula 
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DTFBTISID (Define The File End; BT^M). 

mis itiacro instruction does not require storage at execution tine. 

DFTRMLSr (Define The Terrninal List;. BTA^4). 

Table _ Requirements for _OPENLST_and_WR?^PLSr 

Size = n (m + 1) +2 

wtiere: n = number of list entries 

m = number of polling/addressinq characters -- a function of the device, as shown 
in Figure 20-2. 



Device 



1 1030 




1 1 


1 1050NS 




2 1 


1 1G50S 




2 1 


1 1060 




2 1 


1 2260L 


Not 


applicable | 


1 2260R 




2 1 


1 2740 


i^Ot 


applicable | 


1 2740c: 


Not 


applicable 1 


1 2740D 


iMot 


applicable | 


1 2740DC 


iNlOt 


applicable | 


1 2740Dr 


Not 


applicable | 


1 2740DTC 


Not 


applicable 1 


1 27403 




1 1 


1 2740SC: 




1 1 


1 2740DC0 


Not 


applicable | 


1 2740CO 


Not 


applicable | 


1 3277R 




5 1 


1 USA 




2 1 


1 83B3 




2 1 


1 1130 




2 1 


1 2780 




3 1 


1 ^TTA. 


Not 


applicable | 


L J 


L 


J 



Figure 20-2. BTAM — Number of Polling/A.ddressing Characters 

Table Requirements for _DIft.LSr 

Size = n(m +1) +l+q+p+i 

where: n = number of list entries 

m = values specified in Figure 20-2 

q = 2 if the list includes entries for polling or addressing 

= otherwise 
p = number of dial digits 
i = 3 if the in-list operand is coded (BSC) 

= otherwise.. 

Table Requirements for IDLST 

Size of TviX calling list = d + 5 + 2b 

Size of TWX answering list = 5 + b 

Size of BSC IDLST only =3+d+2r+s+i 

wnere: d = number of dial digits 

b = number of TWX ID characters 

= otnerwise 
r = number of ID characters expected to be received (BSC only) 
s = number of ID characters to be sent (BSC) 
i = 3 if the in-list operand is coded (BSC) 

= otnerwise. 
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Table Requirements f or_SSL?VST/SSA/JLST 

Size = n(m + 1) + 6 

;tfnere: n = number of list entries 

m = values specified in Figure 20-2. 

Table Requirenfients „f or ^OTOLST/AUroWLST 

Size = n(m + 2) + 819 

wnere: n = number of list entries 

(ti = values specified in Figure 20-2. 

Table Reguirementsfor WTTALST 

1. ^^nen the ^RQ feature is present in DTFBT: 
Size = 3 + 2r + s 

2. Wiien the lAM feature is present, and v>fRU is not present in DTFBT: 

Size = 2 + s 

ivtiere: r = number of ID characters expected to be received 
s = number of ID characters to be sent. 

i£MOD_iBrAM_Logic_^5qdule)_ 

Tne size of the BTAM module varies with the options selected as shown in Figure 20-3. 
When all operands are omitted or the standard (default) options are coded, tne resulting 
basic module requires 7811 bytes of main storage. 

BTAM DATA EVENT CONTROL. .BLOCK TABLE RESUIREyLEMTS 

Size = 40 bytes 

ifltien. the MF operand of a READ or WRITE macro is coded MF=L, or wnen the MF operand is 
omitted, a DECB (Data Event Control Block) is reserved. One DECB should be reserved per 
line. 

SCANRE2_DECB_RE2yiREMENTS 

Size of each DACA = 24 bytes 

When the MF operand of a SCANREQ macro is coded MF=L, or when the MF operand is omitted, 
a DACA (Display Alphameric Control Area) is reserved. One DACA should be reserved per 
device. 
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p y ^ 

I Operand | Option | Number of b^^tes adaed to basic nnodule 



-2237 



ERL03IC=* 



+ 351 
-1942 



YES 



+ 712 (If BUFFER=NO, BSOTEST=NO) 

+ 2813 (If B[JFFER=!i:i:.S, BSC=i:ES, BSCTEST=NO) 



+ 4340 (If BOFFER = YLS, BSC:TEST=yES) 



swirca 



NEWID 



+1034 (If BUFFER=NO, BSCTEST=NO) 

+3135 (If BUFFER=Y£S, BSCTEST=NO) 

+ 4662 (If BUFFER=5irh;S, BSC=yES, BSCTEST=^ES) 



AUDIO 



!^ES 



+ 468 (SWITCH must equal YES) 



YES 



+2077 {If L2260=WO and L3277=NO) 
+ 1835 (If Ii2260 = YES or L3277 = YE3) 



BUFFER= 



REQREL 



+ 681 (If L2260=NO and L3277=NO) 
+ 781 (If L2260=YES or L3277=YES) 



TERiyiTsr= 



YES 



+ 1028. 



- 616 (If ERLOGIC=U) 



L2260= 



L3277 



YES 



NO 



-2964 


(If 


S3=N0) 


+ 1917 


(If 


ERLOGIC=E) 


-2720 


(If 


S3=N0) 


+ 2268 


(If 


ERLOGIC=C) 


-2595 


(If 


S3=N0) 


- 321 


(If 


ERL0GIC=i4C) 



-2899 (If SS=NO) 



* Os8 the ERLOGIC storage estimate only if neither L2260, nor L3277,| 
nor SSAPL is specified. ) 

L J 

Figure 20-3. BTAM — Storage Requirements (Part 1 of 3) 
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r T T 

Operand | Option | Nunfiber of b/tes added to basic module 



+ 860 (If ERL0GIC=.O 



-1299 (If S3=N0) 



L2260 



L3277 



NO 



YES 



+ H057 


(If 


ERLOGIC=E) 


- 705 


(If 


SS=NO) 


+ UHOH 


(If 


ERLOGIC=C) 


- 580 


(If 


SS=NO) 


+ 1529 


(If 


ERLOGIC = iJC) 



-1174 (If SS=NO) 



L2260 



L3277 



YES 



YES 



+ 1745 (If ERLOGIC=lnI) 



- 700 


(If 


SS=N0) 


+ 4864 


(If 


ERL0GIC=L) 


+ 190 


(If 


SS=NO) 


+ 5215 


(If 


ERLOGIC=C) 


+ 315 


(If 


SS=NO) 


+ 2040 


(If 


ERL0GIC=ljC) 



- 575 (If SS=NO) 



TST3277 



YES 



+ 978 (nL3277 must equal YES) 



rRAN3L= 



YES 



+ 170 



+12066 (If SWirCd=YES and BUFFER=YES) 



BSCS = 



YES 



+ 6068 


(If 


SS=NO) 


+ 8949 


(If 


S^irCtl=YhS and BUFFER=NO) 


+ 5128 


(If 


SS=NO) 


+ 6435 


(If 


SiJirCH=NU and BUFFER=NO) 


+ 2934 


(If 


SS=NO) 


+ 9389 


(If 


S»JirCH=NO and B[JFFER=YES) 


+ 5795 


(If 


SS=NO) 


+10257 


(If 3wfirCH=i']E^ID and BaFFER=NO) 


+ 7212 


(If 


SS=NO) 


+13390 


(If StfITCH=LNiErtID and BUFFER=YES) 



+10335 (If SS=NO) 



Figure 20-3. BTAM -- Storage Requirements (Part 2 of 3) 
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r T T 

I Operand | Option | Number of bytes aided to basic ntiodule 
|. 1 



I SSAPL= 



ZES 



-1151 (If ERLOGIC: = lvi) 
+1622 (If ERLOGIC=L) 



- 856 (If ERLOGIC=NC) 
+1981 (If ERLOGIC=C) 



BSCMPr^ 



YES 



+ 1190 (BSCS niust equal ^iTES) 



WTT?\ 



YES 



+ 360 



BSCPESr 



YES 



+ 4122 (BSCS nnust equal YES) 



DECBEXr 



YES 



50 (BSCS must equal YES) 



I RMSR = 

I 

I 



YES 



+1474 (If L2260=NO and L3277=NO) 



+ 1714 


(If L2260=YE3 and L3277=WO) 


+ 1494 


(If L2260=NO and L3277=YES) 



+ 1966 (If L2260=YES and L3277=YES) 



I RESEIPL I NO 

L L 



- 128 



Figure 20-3. BTA.M -- Storage Requirements (Part 3 of 3) 
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Module Outline 



core image library 293 

transients 293 

relocatable liorary 293 

modules 293 

basic QIAM logic modules f.... 293 

QIAM device I/O modules 293 

delete statements 296 

source statement library 297 

macros 297 

QTAM storage requirements 298 

DTFQT (define tne file; QlhfA) 298 

control information 299 

buffers 300 

QTAM macro instructions... 300 
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Module Index 



basic logic modules and storage 

requirements 293 

basic QTAM logic modules 293 

buffer requiremf^nts, nonaudio 

applications 300 



control information storage 

requirements 299 

core image library 293 

core image library blocks 

(transients) 293 



real storage destination queue, 
table requirement 299 

real storage process queue table 
requirement 299 



M 



macros, IBM-supplied 297-304 

macro instructions storage 

requirements 301-304 

module names 293-295 

modules, number of 293 



relocatable library 

relocatable liorary blocks. 



293 
293 



delete statements 296 

device I/O modules requirements 293 

DTFQT 

(define the file QTAM), size of 

tables 
audio output queue table 

requirements (QTAM) 299 

checkpoint records table 

requirements 299 

communication line group file 

table requirements , 298 

library book (macro) names 297 

library book (macro), number of 297 

message queues file table 

requirement QTAM. 298 



source statement liorary blocks 
source statement library macros, 



transient routines 

transients, IBM-supplied, 



297 
297 



293 
293 



values for communication line 
group table , 



298 
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22RE_IM^GE_LIBRAR^ 

r T 1 

1 Transients | Blocks | 
j. 1 ^ 

I 23 I 35 I 

L X J 

Transients 



$$BC2C01 
$$BC2C02 
$$BCgc:03 
$$BC2C04 
$$BOQ001 
$$BO2O02 
$$BOQO03 
$$BOQO04 
$$BO2O05 
$$BO2O07 
$$BO2O08 
$$BQCNCL 
$$B2C[SICvi 
$$B2HDCK 
$$BQ^TRA 
$$BQ/JTR1 
$$BQi/JTR2 
$$B2i*TR3 
$$BQ1030 
$$BQ1050 
$$BQ1060 
$$B22260 
$$BQ27U0 



Close Pnase 1 

Close Phase 2 

Close pnase 3 

Close Phase 4 

Open Monitor/DPi3D Message 2ueues, Pnase 1 

Open Line Group and yiain Storage Process/Destination 2ueues 

Open cneckpoint/Restart, Phase 1 

Open Checkpoint/Restart, Phase 2 

Open Main Storage Process/Destination Queues 

Open Phase 7 

Open A.udio Line Group and Output Q'Jsue 

Cancel 

Cancel 

Ternninal Test Header ?lnal/sis 

A.RU Message Writer 

Message Writer, Phase 1 

Message Writer, Phase 2 

Message Writer, Phase 3 

Terniinal Test Module for IBM 1030 

Temdnal Test Module for IBM 1050 

Terminal Test Module for IBM 1060 

lernninal Test Module for IBM 2260 

Terminal Test Module for IBM 2740 



RELOCATABLE LIBRARY 



1 Modules 
1-- 



Blocks 



109 



393 



Modules 

B^SIC_2rAM_L03IC_M0DULES: Basic QTAM logic modules are identified by one asterisk (♦) 
preceding the listed module. 

2rAM_DEV;iCE_I/0_M0DULES: QTAM device I/O modules are identified oy two asterisks (**) 
preceding tne listed module. Include the storage requirements for a particular device 
I/O module only once, and only if the terminal type is present in the system. 



Module 




1 Bytes of 


DJame 


Description 

L 


1 Storage 
J. - 


"I 
IJLQAA 


r 

Audio line appendage 
Note: Required if the QTAM auaio support is selected. 


1 23B6 


IJLQAD 


Audio 7772 disk appendage 


1 2898 


IJLQBO 


Breakoff (BREAKOFF) 


1 212 


*IJL2CK 


Checkpoint 


1 1208 




Note: Required if the Checkpoint/Restart facility is selected in 


the| 




DTFQT. 




IJL2CL 


Change line (STARTLN and STOPLlJ) 


1 557 


IJLQCM 


Cancel message (CANCELM) 


1 160 


IJLQCP 


Change polling list entry (CfctNGP) 


1 146 


IJLQCR 


Checkpoint request (CKREQ) 


1 98 


IJLQCT 


Change terminal table entry (CnNGT) 


1 250 



L J. X J 
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j Module 
I Name 

h 

|*IJLaDA 



IJLQDC 
IJL2DE 
IJLQDL 
IJLQDP 
IJLQDQ 
IJLQDT 
IJLQEA 
IJLQEB 
IJLQEC 
IL2ER 
IJLQEX 
IJLQFL 
IJLQ3A 
IJLQ3B 
IJLQ3C 
IJLQ3D 
IJL23M 
IJLQ3R 
IIJLQ33 
I+IJL2IP 
IIJLQir 

I 
|*IJL2LC 



IJL2L3 
IJL2LK 
♦IJL2LD 

IJLQMC 

IJLQMI 

IJLQMM 

IJL2MP 

IJLQMr 

♦IJL2MW 

♦♦IJL2M0 

♦♦IJL2M1 

♦♦IJL2M2 

♦♦IJL2M3 

**IJL2M*t 

♦♦IJL2M5 

♦♦IJL2M6 

♦♦IJL2M8 

♦♦IJL2M9 

♦♦IJL2N0 

♦+IJL2N1 

♦♦IJL2N2 

♦♦IJL2N3 



|**IJL2N'» 

I 

|**IJL2N5 

|**IJL2N6 

1**IJL2N7 

I 

|**IJL2N8 

(IJLQOA 

1 IJLQOB 

IIJLQOC 

IIJLQPA 



Description 

Disk I/O module 

Not®' ^^^ required when the systenn contains only audio devices. 

Copy counters (COPYC) 

copy terminal table entry (COPYD 

Distribution list 

Copy polling list entry (C0P5fP) 

Copy queue control block; status (20PYQ) 

Insert date in message neader (DArESTMP) 

End-of-Address (EDA) 

End-of-Block (EOB) 

End-of-Block and line correction (EOBLC) 

Error message (ERRMSG) 

Expand message header 

DTF locator 

Get audio message 

Get audio or nonaudio message 

Get audio message or nonaudio message record (GET) 

Get audio message or nonaudio message segment (GET) 

Get complete message (GET) 

Get message record (GET) 

Get message segment (GET) 

QTAM implementation 

Intercept message (INTERCPT, permanent queueing) 

Line appendage and ERP module PCI and program 

Note: Not required when the system contains only audio devices. 

Line appendage for PCI and program check, module 

Note: Not required when the s/stem contains only audio devices. 

Audio input message logging (LOGSEG) 

Lookup terminal table entry (DIRECT) 

IB^4 2260 local appendage 

Notes Required if the IBM 2260 local device is used. 

Conversational mode (MODE) 

Initiate mode (MODE) 

Message-mode interface (MODE) 

Priority mode (MODE) 

Compare message type (MSGTYPE) 

Error recovery procedures message writer subtask 

Model channel program for IBM 1030 terminals 

Model channel program for IBM 1060 terminals 

Model channel program for IBM 2260 terminals 

Model channel program for AT6T 83B3 terminals 

Model channel program for western Union Plan 115A terminals 

Model channel program for IBM 1050 switched and nonswitched termin 

Model channel program for IBM 1050 nonswitched terminals 

Model channel program for AT&T TWX terminals (Models 33 and 35) 

Model channel program for IBM 2260 local terminals 

Model channel program for IBM 2740 basic terminals 

Model channel program for IBM 27U0 oasic dial terminals 

Model channel program for IBM 27ti0 terminals with station control 

Model channel program for IBM 2740 terminals with station control 

checking 

Model channel program for IBM 2740 dial terminals witn transient 

control and checking 

Model channel program for IBM 2740 terminals witn checking 

Model channel program for IBM 2740 dial terfninals with checking 

Model channel program for IBM 2740 dial terminals with transmit 

control 

Model channel program for World Trade Telegraph terminals (WTT?i) 

Operator awareness 

SDR counter incrementer 

Operator control (OPCTL) 

Put audio message (POT) 



T T 

Bytes of 
Storage 



-+- 



als 



1372 

280 

120 

156 

104 

98 

60 

100 

132 

396 

292 

70 

78 

324 

732 

760 

714 

472 

500 

454 

3692 

140 

4152 

630 

304 

104 

1288 

384 

18 

44 

36 

60 

1359 

194 

168 

206 

102 

91 

207 

194 

113 

75 

99 

166 

172 

221 

198 

128 

192 
156 

356 
1380 
2576 
3530 

370 



-i 
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1- 



viodule 
Name 

IJLQPL 
IJLQPyi 
IJLQPR 
IJLQP3 
IJLQPZ 
IJLQ2r 
IJLQRA 
IJLQRB 

IJLQRC 
IJLQRD 
IJLQR3 
IJLQRM 
IJLQRR 
IJLQRS 
*IJL2R^ 

IJLQRl 
IJLQR2 
IJLQR3 
IJLQRU 
IJLQRS 
IJLQR6 

IJLQR7 
IJLQRS 
IJLQR9 
IJLQ3B 

IJLQSC 
IJLQSB 
IJLQSI 
IJLQSK 
IJLQSD 
IJLQSR 
IJLQSS 
IJLQSr 
IJLQSI 
IJLQS2 
IJLQ3U 
IJLQS5 
IJLQS6 

IJLQS7 

IJLQSS 
IJLQS9 

♦IJLQIA 

IJLQIR 



IJLQTS 
♦IJLQrr 



Description 

Polling limit control (POLLIMII) 

Put complete message (PUD 

Put message record (PUT) 

Put message segment (PUD 

Pause-transnait idle characters (P?^USE) 

Close message control (CLOSEMC) 

Translate table RCVARU: hRU code to EBCDIC 

Translation table RCVirA.2 (EBCDIC to International Telegraph Alphabet 

No. 2) 

Translation taole RCVZ-RCVZC3 (EBCDIC to figure-protected code ZSC3) 

Retrieve message segment by DhSD address (RETRIEVE) 

Route message (ROJTE) 

Release message (RELEASEXl) 

Reroute message (REROUTE) 

Retrieve message header by sequence number (RETRIEVE) 

Physical input/output control 

Note: Not required when the system contains only audio devices. 

Translate table RCV1030: 1030 to EBCDIC 

Translate table RCV1050: 1050 to EBCDIC 

Translate table RCV1050F: 1050 to naonocase EBCDIC 

Translate table RCV1060: 1060 to EBCDIC 

Translate table RCV2260 to EBCDIC 

Translate tables RCV83B3 or RCV115A: AIST 83B3 or ^U plan 115A to 

EBCDIC 

Translate table RCVT^X: ATSr models 33/35 (TWX) to EBCDIC) 

Translate table RCV2740: 2740 to EBCDIC 

Translate table RCV27aOF: 2740 to EBCDIC 

Translation table SNDITA2 (International Telegraph Alphabet do. 2 to 

EBCDIC) 

Translation table SNDZSC3 (figure-protected code ZSC3 to EBCDIC 

Scan message header 

Sequence-in number verification (SEQIN) 

Skip-through cnaracter (SKIP) 

Insert sequence-out number in message header (SEQOUD 

Source terminal name verification (SOURCE) 

Change audio line (STARTARU and STOPARU) 

Skip-on count (SKIP) 

EBCDIC to 1030 

EBCDIC to 1050 

EBCDIC to 1060 

EBCDIC to 2260 
Translate tables SND83B3 or 3ND115A EBCDIC to AT&T 83B3 or MU plan 
USA 

Translate table SNDTWXE: EBCDIC to AT&T models 33/35 — TWX (even 
parity) 

Translate table SND2740: 
Translate table SNDTWXO: 
(nonparity) 

World Trade Telegraph terminals (i^TTA) line appendage 
Note: Required if World Trade Telegrapti support is selected. 
Code translation used in conjunction with QTAM or user-provided 
translate table (TRANS) 

Note: T = number of translation tables. 
Insert time of day in message header (riMESTMP) 
Terminal test recognition (LPSTARD 
Note: Not required when the system contains only audio devices. 



+- 



Translate table SND1030: 
Translate table SND1050: 
Translate table SND1060: 
Translate table SND2260: 



EBCDIC to 2740 

EBCDIC to AT&T models 33/35 -- TWX 



Bytes of 
Storage 

120 
480 
544 
520 
3b0 
474 
266 
266 

266 
124 

48 
234 

72 

380 

1569 

266 
266 
266 
266 
266 
266 

266 
266 
266 
266 

266 
104 
140 

76 

68 
128 
300 

48 
266 
266 
266 
266 
266 

266 

266 
266 

1406 

114 + 

226T 

198 
1394 
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Delete _statements 

To delete the QTAM pnases from the core image library, the QT?\M modules from the 
relocatable library, and the QTAM books fro:ti the source statement liorary, the D£LEr 
statement for the appropriate library ana the name of the phase, module or book to De 
deleted must be supplied. For example: 

// JOB DELETE 
// EXEC MAIWT 

DELErC $$BCQC01,$$BQWTRl,etC. 

DELETR IJL2BO,IJLQCL,IJL2Ciyi,etC. 

DELErS E.BREAKOFF, E. BUFFER, E . CANCELM, etc. 
/g 

To delete both BTAM and QTAM from the core image, relocatable and source statement 
libraries, the DELET statement for the appropriate library and tne following entries must 
be made: For the core image transients, you must supply the DELETC, card witn a separate 
entry for each transient (QTAM and BTAIXl) to be deleted. For the core image phase names, 
enter the delete statement as follows: 

DELETC $$BCTC:01,$$BCOO03,$$BETPRT, etc. 
DELETC IJLB.ALL 
DELETC IJLT.ALL 

To delete both BTAM and QTAM from the relocatable library, enter: 

DELETR IJL.ALL 

To delete the BTAM and QTAM books from tne source statement library, enter the DELETS 
statement with a separate entry for each book to be deleted. The following example shows 
the required delete statements and type of entries to be made: 

// JOB DELETE 
// EXEC MAINT 

DELETS E. CONTROL, E.CANCELM, etc. 
/& 
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SOURCE STATEMENT LIBRARY 

r T 1 

1 Macros | Blocks | 

|. ^ ^ 

I 79 i 2013 I 

L X J 

Macros 

Basic 

fi. ARUMSIYP 
E.BREA.KOFF 
E.BUFA.Ra 

E. BUFFER 

e. cancelm 
e.chec:k?iru 

E, CHW3P 
E.CHNSr 
E.CKRE2 

E.CLosEyic: 

E. C0PY2 

E.COPiTP 

E. C0PY2 

E.COPYr 

E. COUNfTER 

E-CTLTBL 

E. DATESrWP 

E. DIRECT 

E. DTFSr 

E.ENDRC^^ 

E-ENDRE?VDy 

E.END3END 

E.EOA 

E.EOB 

E.EOBLC 

E.ERRMS3 

E.INTERCPT 

E.LCBO 

E.LINE 

E.LINETBL 

E.LIST 

E. LOSSES 

E-LPSr^RT 

E.MODE 

E.MSSrYPE 



E.OPCTL 

E. OPTION 

E. PAUSE 

E.POLL 

E.POLLlyilT 

E.POSTARU 

E.POSTRCV 

E.POSTSEND 

E.PREFIXD 

E. PROCESS 

E.QCBD 

E.RCVdDR 

E.RCVirA2 

E.RCVSE3 

E.RCVZSC3 

E.RELEASEM 

E. REPEAT 

E. REROUTE 

E. RETRIEVE 

E. ROUTE 

E.SENDHDR 

E.SENDSEG 

E.SEQIN 

E.SEQOUT 

E.SKIP 

E.SNDITA2 

E.SNDZSC3 

E. SOURCE 

E.STARTARU 

E.STARTLN 

E.STCBD 

E.STOPARU 

E.STOPLl^ 

E.TERM 

E.TERMTBL 

E.TERMTBLD 

E.TIMESTMP 

E. TRANS 

E.viORD 

E.WORDTBL 

E.^^RU 

SY;st§iD_ Gene rat ion 

E.IJL2DSCT 
E.IJL2TSVC 
E.IJLQDEQU 
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2il^55_SrORAGE_REQ[JIREMENTS 

Ttie storage requirements for QTAlXI depend to a great extent on the configuration of your 
teleprocessing installation and tne nature of your applications. Storage requirements 
increase proportionately as the number of communication lines, terminals, and 
2rAM-provided processing functions increase. These requirements can be estimated from 
formulas and tables presented in this module. 

To determine the storage requirements for the Basic QTAM Logic modules and the QTAM 
Device I/O modules, refer to "Relocatable Library", 

DrF2T_(.Define_The_Filej 2TAM)_ 



Seven types of DTF taoles may be generated by a DTFQT macro instruction, 
estimates for each follow. 

DASD^^essage Queues _Files 

Size = 315 bytes 

Communication Line Group File 

For Honaudio Line Group 

Size = 48 + (128 + 8x) N 



The storage 



For Audio Line Group 

Size = 64 + (161 + Lj. + La + G + x-z) IM 

where: N = number of lines in the line group 

X = a function of the device, given in Figure 21-1 

Lj. = length of input buffers 

La = length of address chain buffers 

G = 9 when using time stamping option, otherwise = 

2 =17 when information mode is used 



Device 



1" 



11030 


1 


8 


I1050NS 1 


8 


I1050S 




10 


11060 




7 


12260 


Remote) 


8 


12260 


Local 1 


5 


I274A 




4 


I274B 




6 


|274C 




6 


I274D 




7 


L 


x_ 





i Device 
I" 



274E 

274F 

274G 

274H 

115A 

83B3 

TWX33/35 

7770 

WPTA 




Figure 21-1. QTAM — Values for Communication Line Group Table 
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Real_3torage_Process_2ueue 

Size ^ 84 + 12x 

irfhere: x - for nonnnixed application, and 
1 for mixed application 

Real Storage Destinat ion Queue 

Size - 80 bytes 

^dt^ckpoint_Records_File 

Size = 220+L 

where: L - length of the checkpoint record specified by the SO;^A. keywora operand. 

^I^^i2_5i^t.gut_^ueue 

Size = 76 bytes 

C0NTROL_INFOR^5ATI0N 

The storage estimates for required control information are shown in Figure 21-2. 



I Control Blocks and Information 
1-- 



Storage Requirements (in bytes) 



Terminal table 

TERMTBL macro instruction 

OPTION macro instruction 



TER.Vl macro instruction*- 



LIST macro instruction*- 



PROCESS macro instruction*- 



12 



No Storage is reserved for this macro; it defines 
user areas that are included in the expansion 
of the TERM macro instruction (U parameter) 



9-t-±-i-a + D + 1UF 
where: {1 + U + D)<243 



12 + L + 2N ■^ mO^ 
where: ( 3 ■^ L +2bi'i<2^3 



13 ■^ A. for audio process program entry 
9 + Y for nonaudio process program entry 



Polling list 

POLL macro instruction^ 



4 -H 3N for autopolled terminals except IBM 1030 

4 ■^ 2N for nonswitched terminals or autopolled 
IBM 1030 

5 for switched IBM terminals 
3+1 for TrtX 

4 ■^ T for v^TTh terminals 



Queue Control Block for Process 
Queues and Destination Queues 



32X 



Audio Line Table 

LINETBL macro instruction*- 

LI[^E macro instruction*- 



4 

5 + Z 



A.udio /Jord Table 

WORDTBL macro instruction*- 

/JORD macro instruction*- 



I 8 + W 
.X 



Figure 21-2. QTA.M -- Storage Requirements for Control Information (Part 1 of 2) 
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r 

■ffhere: 

N = namber of terminals 

I = nu:Tiber of bytes in terminal ID 

tJ = number of bytes in optional area 

D = number of bytes in device address area; size depends on contents: 

For nonswitched terminal — addressing and polling characters (1 byte/cnaracter) 

For IBM switched terminal -- field telling the number of dial digits (1 byte) + dial 
digits (1 byte/digit) + addressing characters (1 byte/character) 

For I'fi^ ~~ field telling the number of dial characters (1 byte) + dial digits <1 
byte/digit) + field telling the number of ID characters (1 oyte) + ID cnaracters (2 
bytes /character) 

For flVTA ternninals -- 1 byte + field telling the number of ID characters (1 byte) + ID 
characters (2 bytes/character) 

For IBM 2260 Local -- a field of 6 fullwords consisting of a CCB and otner control 
information 

L = number of bytes in name of the distribution list entry in terminal table (1-8) 

A ~ number of bytes in name of tne audio process entry in tne terminal table. Because 

the following field in the entry mast oe aligned to a fullword boundary, this field 

must be either three, seven or eleven bytes long. 
JC = number of lines or terminals (depending on queueing techniques) and the number of 

process queues 
5f = number of bytes in name of the process entry in terminal table (1-8) 
Z = number of bytes in name of the line entry in line table (1-8) 
irl = number of bytes of the selected word 
F = 1 for IBM 2740 Model 2 terminals with the Buffer Receiver Option; for other 

terminals 
r = number of bytes in the CPU identification (WTTA terminals) 

|. ^ 

Notes : 

1. ?!Ldd the number of bytes necessary for fullword boundary. 

2. This number (140) is the number of bytes in the Distribution List module (IJLQDL). 
This number is included in the storage requirements only once if the LIST macro is 
used more than once. 

3. ^dd the numoer of bytes necessary for halfword boundary. 
L J 

Figure 21-2. QTAM -- Storage Requirements for Control Information (Part 2 of 2) 

Buffers 

For Nonaudio A.pplications: 

Buffer Pool Size = 8+(x+16)N + 24M 

N = number of buffers specified 

X = size of each buffer 

M = number of CCWs QTA.M generates for data insertion by the Pf^USE macro. 

QISlM Macro Instructio ns 

Figure 21-3 gives the storage requirements for all other QTAiyi macro instructions. 

Much QTAM logic consists of modules introduced by the use of certain QTAM macro 
instructions in the user's program. These macro instructions expand into inline coding 
that establishes the linkage to, and parameters for, the QTAlM modules. Often a module so 
introduced into the system itself introduces another module, a process termed a second 
level routine. 
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Colunnn two of Figure 21-3 shows the extent of the co3ing produced by tue expansion of 
the macro instruction in column one. If the coding links to 2TAM module, tne module is 
presented in column three; if that module links to other modules, they are presented in 
column four. 

Storage requirements for a sharable nnodule, or for a second level routine that is 
linked to more than once in the same partition are included only once. For example, the 
macro instructions DIRECT, EOh, and ROUIt; all link to the same module, IJLQLK. If two or 
more of these macro instructions are used in the same message control program, tne module 
is included only once. Similarly, if the same macro instruction is used more than once 
in the same program, storage is required for only the additional linkage because the 
module is included just once. 



Macro Instruction 
ARU!AGTYP 



Inline 
Linkage 
or ::ode 
(Note 5) 



Second Level 
Sharable Modules 



Name 



Size 



Routine 



Name | Size 
+ 



16 



BREAKOFF 

ANCELM 
CHECKARLF 



IJLQBO 



212 



IJLQCM 



160 



70 + 
message 
text 



CHNGP 



H2 



IJLQCP 



146 



IJLQFL 



:HNGr 



26 



IJLQCT 



250 



CKREQ 



10 



IJLQCR 



98 



ILOSEMC 



IJL22T 



U74 



IJLQCL 



549 



;OPYC 



24 



IJLQDC 



504 



copyp 



34 



IJLQDP 



104 



IJLQFL 



COPYQ 



34 



IJLQDQ 



98 



COPY! 



30 



IJLQDE 



120 



COUNTER 



12 



DATESTMP 



IJLQDT 



60 



IJL2E)C 



70 



DIRECT 



12 



IJLQLK 



104 



ENDRCV 



10 



Note 1 



■+ 



ENDRCV (WTTA) 



16 



IJLQEB 



132 



ENDRER.DY 



80 



Note 1 



ENDSEND 



10 



Note 1 



EOh 



28 



IJLQEA 



100 



IJLQSH 
IJLQSK 
IJLQR3 
IJLQMT 
IJLQLK 



104 
76 
48 
60 

104 
Note 2 



Figure 21-3, QTAM -- Storage Requirements for Other Macro Instructions (Part 1 of 5) 
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380 
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- 4. 
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ERRMS3 








32 + 


IIJLQER 




292 


1 IJLQLK 




104 1 








1 message 
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1 


text 
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1 




- X - 
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1 
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T 




GET 






















Segment 










tIJLQGS 
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454 




X 






r 


1 




T 
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Message 










IIJLQ3M 
1- 


-f- 


472 
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-+- 




Record 
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IIJLQGR 
-+ 


-+- 


500 


-- + 


-+- 




GET (ADDIO) 






















Audio message 










IIJLQGA 




324 








Audio and non- 


-audio messages 






IIJLQ3B 




732 








Audio message 
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714 
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12 
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LOSSES 
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i. 




1 
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- X 


X 














t 


1 




t 


t 




LOSSES (ARU) 






1 


26 


IIJLQLG 


_i 


304 


- X 


x_ 














t 


1 




t 


t 




LPSTARr 






1 


28 


|Note 1 

4. 


1 




_ X 


X 










t 




T 


1 




t 


t 




MODE (C) 






i. 


14 


IMODE (U) 
1 module 6 
ilJLQMM 


1 


44 


IIJLQSH 
_ X 


X 


104 1 












T 


1 




t 


T 




MODE (U) 






















INITIATE 








10 


IIJLQMI 

L 


-4- 


18 


_ X 


X 






r 


1 




t 


T 




PRIORITY 








10 


IIJL2MP 

L 


1 


36 


lIJLQSri 
_ X 


X 


104 1 




r 


i 




t 


t 




CONVERSE 








10 


1 IJLQMC 
JNote 1 

L 


1 


384 


X 


x_ 






r 


1 




t 


t 


1 


MOD2260 






1 


n 


4. 


_ 1 




- X 


X 














T 


1 




t 


t 




MSSTfPE (C) 






I 


19 


IIJLQMT 
J 


i 


60 


IIJLQSH 
- X 


x_ 


104 1 












T~ 


1 




t 


1 — 




MSSTyPE (U) 






i. 


4 


4. _ 


_ 1 




-_X 


X 














t 


T 




— t 


t 




OPCTL 








56 


IIJLQOC 




3610 


1 IJLQLK 
1 I JLQSH 
1 IJLQCL 
1 Note 1 




104 1 
104 1 
549 1 



L X J J X X J 

Figure 21-3. QTAM — Storage Requirements for Other Macro Instructions (Part 2 of 5) 
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r T T- T~ 1 

1 1 Inline | j Second Level | 
1 1 Linkage | Sharable Modules | Routine j 

1 1 or Code j- y -j- -p -j 

[Macro Instruction ((Note 5) j Name j Size j Name j Size j 
^ 1 + 1 1 + ^ 

1 PAUSE 1 13 + IIJLQPZ 1 360 | Note 1 | | 
1 1 insert | | ill 

I. 1 + ^ ^ 1 ^ 

jPOLIIMir 1 12 IIJLQPL 1 120 | | j 

i. + + f 1 + ^ 

IPOSTARQ 1 6 1 1 Note 1 | | | 
L » t - — -J. - - J - 4.- 4- - J 


r T T 1 T T 1 

|postr::v I 6 |Note 1 | 1 | | 

i. 1 1 1 1 1 ^ 

jPOSrSEND 1 12 |Note 1 1 1 1 1 
j. ^ + ^ 1 1 ^ 

|PUT 1 1 1 111 
1 Segment | jIJLQPS | 520 | j j 

1 Message | jIJLQPM | U80 | | | 

1 j |. 1 1 1 ^ 

1 Record | | IJLQPR | 544 | | | 

i. 1 ^. ^ + ^ ^ 

|PUT (?^UDIO) 1 IIJLQPA 1 370 | | | 
|. 1 + 1 1 ^ ^ 

1 RCVHDR 1 8 1 1 1 1 1 
|. 1 + 1 1 1 ^ 

1 RCVSE3 Note 4 1 1 | III 


r ~ ~ ~ ~ ' " T T ~T *" ~ T T ~1 

jRELEASEM 1 12 j IJLQRM | 230 | | ( 
^ ^ 4- 1 + ^ ^ 

1 REPEAT j 34 1 INOte 1 | | j 

i. ^ ^ ^ + j^ ^ 

iREROaiE i 26 IIJLQRR | 72 | IJLQLK | 104 | 
1 1 (Note 11 1 1 1 
L_ _ _, _ _ _ _ _X J.- - -4. J X J 


r — _ _ _ -^ ^_ _ -^ ^_ ^ ^ 
I RETRIEVE 1 1 1 III 
jDASD address | 14 j IJLQRD | 124 | | ] 
1 1 |. ^ 1 1 ^ 

|By sequence number | 26 | IJLQRS j 380 | IJL2RD | 124 j 

i. 1 1 1 1 + ^ 

1 ROUTE 1 8 IIJLQRG | 4 8 | IJLQLK j 104 I 
1 ill jlJLQSH 1 104 1 
j. 1 1 1 1 1 ^ 

ISENDHDR 1 16 j j | | ] 
|. ^ ^ ^ ^ + ^ 

ISENDSE3 Note 4 1 ^ 1 1 t 1 1 

L _ J. _ _ X - J- J. J. J 


r — ~ T ~ - r T t t 1 

|SEQIN 1 8 IIJLQSI | 140 | IJLQSH j 104 | 

L _ _ _ 4._ _ L_ J. J. i. _j 


r — T -^- f ^ — y -^ 
ISEQOai 1 8 jIJLQSO | 68 j IJLQEX j 70 | 
L _ _ _ _ i. _ _ J. X _ 4- X 4 


r _ _ _ _ ^ _ _ ^ ^ _ ^ ^ ^ 

|SKIP (CT) 1 8 jIJLQST | 48 j IJLQSH | 104 | 

L _X _X _X _X X J 



Figure 21-3. QTAM -- Storage Requirements for Other Macro Instructions (Part 3 of 5) 
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T T 

Inline | 

Linkage | Sharable Modules 

or Code |- -p 

(Note 5) Name Size 



iVIacro Instruction 



I Second Level 
I Routine 

■ + T 

I Name | size 



SKIP (S) 



I- 



+ no. IIJLQSK I 

to be I I 

skipped I I 



76 j IJLQSH I 104 



SOQRCE 



8 IIJLQSR I 128 IIJLQSH | 104 



STARr?VRU 



42 IIJLQSS I 



300 



IIJLQFL I 
4- 



SrARIIN 



12 jIJLQCL I 512 IIJLQFL | 



-+- 



STOPA.Ra 



42 IIJLQSS 1 



300 



IJLQFL 



78 
78 
70 



SrOPLN 



12 IIJLQCL I 



512 
198 



IIJLQFL 

+ 

IIJLQEX 

'f 



TIMESrMP 
TRANS 



8 jULQIS I 



10 IIJLQTR I 



114 + 
266 + T 



4- 



vJRU 







u = 
s = 
cr = 

T = 



ctiaracter operand specified (conditional) 

cnaracter operand null (unconditional) 

skip to and include designated character configuration 

skip designated count of nonblank characters 

number of translation tables. 



Translation tables are: RC71030, RCV1050, RCV1050F, RCV1060, RCV2260, RCV2740, 
RCV2740F, RCVARU, RCV83B3, RCV115A., RCVI'WX, RC:VirA.2, RC:VZSC3, SND1030, SiSlDlOSO, 
SND1060, SND2260, SNDITA2, SNDZSC3, SND2740, SND83B3, SND115R, SNDTWXE, and SNDIi^XO 



Figure 21-3. QTA.M -- Storage Requirements for Other Macro Instructions (Part 4 of 5) 



Notes 



These delimiters or modules cause linkages to QTAM routines included in "Basic 
QTAM Logic Modules" listed earlier in this module under "Relocatable Library". 

If the macro instruction MS3TYPE, ROUTE, or SKIP (S) is used in the program, tne 
storage estimate for IJLQMT, IJLORG, or IJLQSK, respectively, is not included in 
the storage estimate for EOh, 

Because the user defines his own DTFxx and xxMOD macros for his message log file, 
the size requirements cannot be specified here. Information to determine the 
storage requirements for the specific logging medium is given under the pertinent 
DTF and Module, that is, DTFMT and MTMOD for Tape. Modules 7-18 contain storage 
requirements 'for declarative macros. 

Identifies entry point for RCVSEG and SENDSEG subgroups of LPS. 

rne linkage requirements for OPEN, CLOSE, GET, and PUT are given in Module 1. 



Figure 21-3. QTAM -- Storage Requirements for Other Macro Instructions (Part 5 of 5) 
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Introduction 

This section of the manual presents a method for estimating the amount of storage 
required to run VTAM level 2 (referred to as VTAH) under DOS/VS. For further details, 
refer to DO^Vg VtAfl Concepts and Planning, GC27-6998. Information on library 
requirements, VTAW phases, modules and transients, and link-edit statements is given 
under "VTAH Ccmponents". 

Storage Estimates for VTAM 

mis chapter discusses tne method for estimating the amount of virtual, real, and 
auxiliary storage required to run VTAM under DOS/VS. It also shows how to calculate the 
VTAM storage pool parameters. A sample calculation for the ALLOC and ALLOCR macro 
instructions is given in Figures 22-^4 and 22-5. 

rne results of the estimates are used duriag system generation and VTAyi 
initialization. The virtual and real partition size values are to be specified in tne 
ALLOC and ALLOCR job control commands, the storage pool parameters during the starting of 
VTAM, and the value for the SIZE parameter is to be specified in the EXEC job control 
statement or the job control command. 

The method for estimating the amount of storage required for VTAM and for calculating 
the VTAM storage pool parameters is based oa a series of work sheets (WS.) that allow the 
user to define and calculate the requirements step-by-step. As in all telecommunications 
systems, many variables affect the actual storage requirements. Many of the variables 
are precisely defined by the selection of options and functions, and of the network 
configuration. Other variables, nowever, are related to the user's specific 
applications, and as such, are affected by dynamic changes that occur during the 
execution of tne application program. Tnus, in tne work sheets, where precise values are 
not available, guidelines are provided to allow to analyze tne requirements and select 
values applicable to the specific installation. The storage and buffer pool calculations 
found in the work sheets represent starting values which can be changed oy using the VT.AM 
storage pool trace facility. 

The calculations for the virtual and real partition size nave to cover the various 
functional components of VTAM. It will be easier to understand the structure of the 
necessary calculations by referring to Figures 22-1 and 22-2; they show the composition 
of the virtual and real partitions of VTAM. Figure 22-1 maps all the VTAM components 
contained in virtual storage. Similarly, Figure 22-2 maps all the components that reside 
in real storage. 
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Low Virtual 
Address 



J. ^ 

VrAM initial load area. This is the program that is loaded when VTAM 
is started. This area also contains the partition save area. 

(Component - LOADINID 



This is the GETVIS map that is built to manage the storage allocated 
from the partition. 

(component -• STORMAP) 



Address table for modules loaded into the VTAM partition. 

(Component - ALOADTBL) 



VTAM pageable modules loaded from tne load list, 
packed in this space. 

(Component - VTMDDS) 



Tne working set is 



7TAM pageable buffer storage pools. (This area should be added only if 
PAGPOOLS are not to be taken from the SVA.) 

(Component - PAGPOOLS) 



VTAM pageable modules loaded from the module lists in tne skeleton 
DVTs. 

(Component - DVTP40DS) 



VTAM modules loaded by the ATTACH function. 

(Component - ATCHMODS) 



VTAM tables loaded by SYSDEF. 

(Component - SYSALOAD) 



\r~- 



Space reserved for the loading of TOLTEP modules. 

(component - TOLTWKA) 



VTAM modules to be fixed in real storage. 

(component - FIXDMODS) 



VTAM buffer storage pools to be fixed in real storage. 

(Component - FIXPOOLS) 



VTAM modules to be fixed in real storage. These modules are the I/O 
appendages. 

(Component - lOAPPEN) 



|. 

This space is reserved for EXCP buffers for the TRACE and LOAD/DUMP 
functions to be fixed in real storage. 

(Component - EXCPBUF) 

L 

Figure 22-1. VTAM Virtual Partition Map 
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Low Real 
Address 



VTAM modules that have oeen fixed in real storage, 
area precedes the first fixed module. 

(Component - FIXOMODS) 



Tne partition save 



VTAM buffer storage pools that have been fixed in real storage. 

(Component - FIXPOOLS) 



VTAM modules that have oeen fixed in real storage. These modules are 
the CE and ATTN appendages. 

(Component - lOAPPEN) 

EXCP buffers that have oeen fixed in real storage. 

(Component - EXCPBUF) 



Figure 22-2. VTAM Real Partition Map 



Figure 22-3 shows the calculation subject and the rel 
through D7). Most important, it shows the hierarchic 
The structure in some cases is such, tnat a string of 
completed before the desired value can actually be ca 
calculation for "RDT" (identified by D2) can only be 
tnrougli D2.5 have been calculated, because these resu 
"RDT" calculation. It will be helpful to become fami 
by reading the individual work sheets and relating th 
reason of context. Work Sheet C3 is included after Wo 
the work sheets are performed in bytes, except where 



ated work sneet identifier (A. 
al structure of the calculations, 
lower-level calculations must De 
Iculated. For example, the 
started when the results of D2.1 
Its are required as part of the 
liar with the calculation structure 
em to Figure 22-3. Note that, for 
rk sneet D7. All calculations on 
noted. 
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SWITCHED 
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Figure 22-3. Hierarchical Structure of VTAM Storage Calculations 

Identifiers A, Bl, and so on, relate to the work sneet (WS,) 

To accurately determine VTAM storage requirements, it is necessary to have information 
about the installation in which VTAM will be operating. An outline of tne information 
required is as follows: 

1. TP hardware configuration (as deternained by all NCPSEN decks and all LOCAL build 
decks) . 

a. [Slumber and types of terminals 

(1) BASIC devices 

(2) Terminal components (for example, 1050 card reader) 

(3) 3270 devices, local and remote 

b. Logical units - remote and local 

c. Number and type of lines 

(1) Dial lines and number of dial digits and size of ID verification data 

(2) Non-Dial lines and number of poll characters 
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d. iSlumber and types of cluster cDntrollers 

(1) SNA Controllers 

(2) Remote 3270 Controllers 

e. Message sizes 

2. Host system characteristics 

a. Is Network Solicitor included? 

O- Types and numoers of operator commands 

c. Number of application programs with OPEN ACBs 

d. Types of VTAM support for I/O 

(1) BA.SIC support 

(2) RECORD support 

(3) 3270 local and remote 

(4) User exits. 

e. Number of concurrent TOLTEP users 

f. Number of messages arriving at nost each second 
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Work Sheet A - VTAM Partition 

Calculations of satns h, B, Z, and D belo^ will enable you to ietermins tne values to 
specify for the VrAf4 partition size (in the ALLOC and ALLOCR statements or commands 
and in the SIZE=parameter of the EXEC state.-nent) . 

Constant requirement for fixed storage 1^, 336 

SUM A= 14^336 

ISTPArCti (if module ISTPArCH has been compiled itfith a patch area 

different from the IBXl-supplied patch area, enter the size 

rounded up to a multiple of 128; if ISTPATCH has not been 

modified, enter 128) . \ 

FIXPOOLS (from WS.B4) 

lOAPPN (from i^S.B2) 

Preliminary SUM B- 

After rounding preliminary SUM B up to 2048, SUM B= 

Constant requirement for pageable storage §84^032 

If SSS is to be run as a subtask, add the size indicated for the 

appropriate interactive or batch phase given under Module 23: SSS 

If BTP is to be run as a subtask, add the size required for BIP 

(see the BTP User's Guide) 

If NEr30L=YES, enter 8192; if NO, enter 

Preliminary SUM C- 

After rounding the preliminary SUM C up to a multiple of 2048, SUM C= 

TOLTWKA (maximum number of current TOLIEP users x 34,816; see 

Note) 

SYSALOAD (from WS.Bl) 

SMSBUF (from WS,B3) 

PA3P00LS (from WS.B5) 

Preliminary SUM D= 

By rounding preliminary SUM D up to a multiple of 2048, SUM D= 

Calculation for ALLOC 

(SUM A + SUM B + SUM C + SUM D)/1024= 

Calculation for ALLOCR 

(SUM A + SUM B)/1024= 

Calculation for SIZE parameter in EXEC statement 

(SUM A + SUM 0/1024= 

Note: The maximum number of concurrent rOLTEP users is equal to the maximum number 
of terminals requiring online diagnostic testing at one time. For small networks, 
this number will be small, probably 1. As the network grows in size, the number of 
terminals requiring concurrent online testing will increase to 2 or more. 
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Work Sheet Bl - Calculation of SYSALOAD 



rtiis area is wnere SYSDEF loads certain tables to be used in building RDIs, rue input 
for tie variables in the calculations should be taken from all Network Control Program 
generation decks, and all LOCSiL and hPPL statement decks for tne VTA.M system. 

Enter the total number of names specified in the name 
fields of the following macros: 

PCCU macros 

3R0aP macros 

LINE macros (botn dial and non-dial) 

TERMINAL macros except for 2980s with two addresses 

specified 

TERMINAL macros for 2980s with two addresses specified 

(multiply by 2) 

COMP macros 

CLUSTER and PU macros 

INNODE macros 

DIA.LSET macros 

LU macros 

LOCAL Statements 

APPL statements 

Value specified in LUPOOL macro 

TERMINAL macros followed by a COMP macro 

TERMINAL macros with CTERM=YES 

VBUILD statements 

LBUILD statements + 

SUM A = X 12 = 



If any SDLC devices are in the Network Control Program 
generation deck, enter 10; otherwise, 



+ 10 

SUM B = 



SUM B rounded up to a multiple of 128 = 

Enter sum of the sizes of all unique user-specified 

MODTABS 

Enter sum of the sizes of all unique user-specified 

USSTABs 

Enter sum of the sizes of all unique user-specified 

interpret tables + 

(Tables referenced more than once are counted only 

once. Derive the sum by rounding each table size up to 

a multiple of 128 and then sum up the rounded sizes.) SUM C = 

Enter number BHSET macros in Network Control Program 
generation decks 

X 

SUM D = 

SUM D rounded up to a multiple of 128 = 
SYSALOAD = 
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Work Sheet B2 - Calculation of lOAPPN 



This area is for the VThM fixed I/O appendage. 

If there will be an activated Network Control Program 
in the VTKM system, enter 5760 

If there will be a local device activated in the VThM 
systenn, enter 4992 

lOAPPN value = 



Work Sheet B3 - Calculation of SMSBUF 

This area is needed by VTAM storage management to 
maintain the variable storage pools. 

Enter the following: 

VPBUF (from irJS.C2) divided by 2048 



SUM h rounded up to a multiple of 12( 
VFBUF (from WS.Cl) divided by 2048 = 



~4 

"72 



SUM h = 



„1 
'72 



SUM B = 



SUM B rounded up to a multiple of 128 

SMSBUF = 

Work Sheet B4 - Calculation of FDCPOOLS 



This area comprises the VTAM fixed buffer pools from 
which all fixed VTAM control blocks and I/O buffers are 
allocated. 

Enter bsz = (from i^S.C3) 

LF 

Enter bno = (from WS.C3) 
LF 

LFBUF = SUM A rounded up to a multiple of 128 

SFBUF 

Enter VFBUF (from irJS.Cl) 

FIXPOOLS= 



24 



X 

SUM A = 



128 
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Work Sheet B5 - Calculation of PAGPOOLS 

bno, bsz, and vbsz are calculated in i^ork Shieet C3. Each pool size total should be 
rounded up to a multiple of 128. 

VPBUF = vbsz = (from ^iS.C2) 

VP 

LPBUF = (bsz + 8) X bno = (from ^S.C3) 

LP LP 

SPBUF = (bsz + 8) X bno = (from rtS.C3) 

SP 3P 

APBUF = (bsz + 8) X bno = (from ^S.C3) 

AP hP 

/JPBUF = (bsz + 8) X bno = (from WS.C3) 

WP WP 

NPBUF = (bsz + 8) X bno = (from WS-C3) 

NP lSIP 

PPBUF = (bsz +24) X bno = (from WS.C3) 
PP PP 



SUM h 



PA3P00LS = SUM A rounded up to a multiple 
of 20U8 = 
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Work Sheet CI - Calculation of VFBUF 



Ttiis area is the VThM variable fixed pool (VFBUF). 

Enter the total number of names specified in the 
name field of the following macros: 

For all 370x subareas - 

DIALSET macros 

3R0UP macros 

LINE macros (dial and non-dial) 

rERMINftiL macros (all kinds) 

VTERM macros 

COMP macros 

Value specified in LUPOOL macro 

INi^ODE macros 

LU macros 

CLUSTER and PU macros 



+ 


2 









X 


8 = 


+ 


SUM A. = 









16 



SNT value = SUM A rounded up to a multiple of 20Ui 
if SUM h is greater than 2048; otherwise, it is 
SUM A 



For all local subareas - 
LOCAL macros 



+ 2 

= K 8 = 

+ 16 

SUM B = 



SNT value = SUM B rounded up to a multiple of 204! 
if SUM B is greater tnan 2048; otherwise, it is 
SUM B 

For all switched subareas - 

PU macros 
LU macros 



X 8 = 

+ 16 

SUM C = 



SNT value = SUM C rounded up to a multiple of 204i 
if SUM C is greater than 2048; otherwise, it is 
SUM C 
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For all 3790 local subareas - 

PU macros 
LU macros 



X 2 = 



X 8 = 

SUM D = 



16 



SWr value = SUM D rounded up to a multiple of 20U8 
if SUM D is greater than 201^8; otherwise, it is 
SUM D 

SNr = SUM A + SUM B + SUM C + SUM D = 

Maximunn number of application tasks 

If NErS0L=YES, enter 1; otherwise, enter 



Maximan number of concurrently active Network 

Control Programs plus locally attached 3790 

clusters 

Maximunn number of concurrently active 3270 LOCAL 

devices 

MAXSUBR. parameter on the BUILD macro in the 

Metwork Control Program generation deck rounded up 

to a power of 2 



x 48 = 

x 528 = 
x 160 = 



X 8 = 

+ 



16 



VFBUF=SUM E rounded up to a multiple 

of 20U8 = 

vbsz=7F 



SUM E = 



SUM F = 



318 DOS/VS System Generation 



Work Sheet C2 - Calculation of VPBUF 



Ttiis area is the VTAM variable pageable buffer pool (VPBUF). 

SZSDEF K/ork area size (from rtS.Dl) 

S^SDEF ROr size (from WS.D2) 

SRTADD size (from WS.D3) ~ 

PSSWKA size (from WS.D4) 

EPTDVr size _iil36 

OPNCLS size (from WS.D5) _~ 

OPNAPPL size (from WS.D6) 

VAR^SIZE (from i^S.D7) 

+ 320 

SUM A = 
SUM B = SUM A X 1.10 = 

VPBUF = SUM B rounded up to a multiple of 2048 = vbsz'VP 



Work Sheet Dl - Calculatioa of SYSDEF Work Area 



This area is the part of VPBUF needed for the system definition 
(sySDEF) work area. 

For a 370x, enter the largest value calculated for a 370x suoarea 
of a SSfSDEF work area (from WS.Dl.l). 

Otherwise, enter the largest of the following values: 

• the largest value calculated for a SYSDEF work area for a 3270 
LOCAL subarea (from HS.Dl.2) 

• the largest value calculated for a SYSDEF work area for an 
APPL subarea (from WS,D1.3) 

• the largest value calculated for a SZSDEF work area for a 
switched subarea (from WS.Dl.4) 

• the largest value calculated for a SYSDEF work area for a 3790 
LOCAL subarea (from WS.Dl.5) 

SYSDEF work area size = 
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Work Sheet Dl.l - Calculation of SYSDEF Work Area for a 370x 



Ttiis calculation must be done for each Network. Control Program tnat will be active in a 
370x in tne VTAM network. The input for the variables in the calculations should oe 
taken frota the Network Control Program generation deck. 

Network Control Program symbolic name = 

Enter the number of the following: 

PCCa macro 1 x 2 56 = 256 

DIALSET macros ~ x 80 = + 

SUM h = 



Subtotal A = SUM A rounded up to 2048 = 

Enter the total number of the following: 

3R0UP macros x 92 = 

LINE macros with DIA.L=NO x 116 = 

LINE macros with DIA.L=YES x 160 = 

TERMINAL macros not followed by a COMP macro (not a 

2980) X 424 = 

TERMINAL macros followed by a COMP macro x 424 = 

TERMINAL macros for a 2980 ~ x 212 = 

VTERM macros ~ x 212 = 

COMP macros x 212 = 

LU macros x 176 = 

CLUSTER and PU macros for clusters on non-SDLC lines x 96 = 

CLUSTER and PU macros for clusters on SDLC lines x 148 = 

Value specified in LUPOOL macro x 84 = 

PU macros on SDLC dial lines x 84 = 

Innode macros x 160 = 

SUM B = 

Subtotal B = SUM B divided by 1881 (rounded up to a 
whole number) x 2048 = 

Enter the total number of the following: 

Unique VIDLIST macros referred to by a VIDSEQ 

parameter on a 3ROUP, LINE, or TERMINAL macro x 8 = 

VIDSEQ parameters on every referenced VIDLST macro x 5 = 

TERMINAL macros that specify DIALNO= that are on a 

3R0UP or LINE macro that specifies DIAL=irES and 

DIALSEr= X 4 = 

Unique LCTYPE parameters for every MTALIST macro 

referenced on a GROUP or LINE macro + 1 x 5 = 

Poll characters specified in the POLL parameter of 
all TERMINAL and COMP macros, and the GPOLL 
parameter of the CLUSTER macros 

Dial digits specified on the DIALNO parameter of all 
TERMINAL macros where the LINE or GROUP macro 
specified CALL=OUT or INOUT 

BHSET macros x 9 = + 

SUM C = 
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Enter ttie number of the f olioii^^ing: 



VIDSEQ parameters for the VIDLISr nacro .^^ith the 
largest number of VIDSEQ parameters x 5 



LCryPE parameters for the MTALIsr tiacr'o with the 
largest number of LCTYPE parameters x 5 



Enter calculated value of 



SYSDEF work area for a 370x subarea = 



+ 
SUM Cl= 



+ 
SUM C2= 



Poll characters from above SUM C3= 

Dial digits from aoove SUM C4= 

BHSET macros from above SUM C5= 

SUM D = 2024 - the largest of SUM CI, C2, C3, 

C4, or C5 SUM D = 

Subtotal C = SUM C divided by SUM D (rounded up 
to a whole number) x 20US = 

Enter the total number of the following: 

VIDLIST macros x 36 = 

VIDSE2 parameters on all VIDLIST macros x 44 = 

MTA.LIST macros x 52 = 

MTA.LCST macros x 20 = 

SUM E =- 

Subtotal D (rounded up to a multiple of 2048) = 



+ 10240 



Module 22: VTAM — 5745-SC-VrM 321 



Work Sheet D1.2 - Calculation of SYSDEF Work Area for a 3270 LOCAL Subarea 



This calculation Tiust be done for every LOC?^L subarea that will be active in tne WThh 
network. The input for the variables in the calculations should be taken froti its 
definition statement deck. 

Enter the number of LOCAL statements x 296 = 

+ 136 

SUM h = 

Subtotal h - SUM K divided by 1813 (rounded up to a 

whole number) x 2048 = '_ 

+ 1221 

SYSDEF work area for a LOCAL subarea = 

Work Sheet D1.3 - Calculation of SYSDEF Work Area for an APPL Subarea 



This calculation must be done for every A.PPL subarea that will be active in the VTAW 
network. The input for the variables in the calculations should be taken from tne APPL 
statement decks. 

Enter the number of APPL statements x 120 = 

+ 136 

SUM A = 



Subtotal A = SUM A divided by 1905 (rounded up to a 

whole number) x 20U8 = 

+ 12281 



SYSDEF work area for an APPL subarea = 

Work Sheet D1.4 - Calculation of SYSDEF Work Area for a Switched Subarea 

This calculation must be done for every switched subarea that will be active in tne VTAM 
network. The input for the variables in the calculations should be taken from its 
definition deck. 

Enter the number of: 

VBUILD statements x 156 = 

PU macros ~ x 14 8 = 

LU macros x 176 = 



136 



SUM A = 



Subtotal A = SUM A divided by 1849 (rounded up to a 
whole number) x 2048 = 

SYSDEF work area for a switched subarea 



+ 10240 
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Work Sheet D1.5 - Calculation of SYSDEF Work Area for a 3790 LOCAL Subaiea 

rtiis calculation nnust be done for every 3790 subarea that will be active in tue VlhM. 
network. The input for tne variables in the calculations should be taken from its 
definition deck. 

Enter the number of: 

VBUILD statements x lUU = 

PU macros x 236 = 

LQ macros x 176 = 



136 



SUM h = 



+ 10240 



Subtotal A. = SUM A divided by 1850 (rounded up to a 
whole number) x 2048 

SYSDEF work area for a 3790 subarea = 



Work Sheet D2 - Calculation of SYSDEF RDT Size 



This area is the part of the VPBUF needed for Resource Definition Tables (RDIs) tnat 
are built by SYSDEF for the subaraas - 370x, hPPL, 3270s LOCAL, 3790s LOCAL, and 
switched. 

Enter the sum of the sizes of all the RDTs for: 

370x subareas (from WS.D2.1) __ 

3270 LOCAL subareas (from W3.D2.2) _[ 

APPL subareas (from WS.D2.3) _] 

Switched subareas (from WS.D2.U) 

3790 LOCAL subareas (from W3.D2.5) +_] 

SYSDEF RDT size = 



Module 22: VTAM -- 5745-SC-vrM 323 



Work Sheet D2.1 - Calculation of the RDT for a 370x Subarea 



rais calculation must be done for every JetiA?ork. Control Program tnat \vill be active in a 
370x in tne vrA.M network. The input for the variables in the calculations should be 
taken from the Network Control Program generation deck. However, most of the variables 
can be taken from ^ork Sheet Dl.l. 



Network Control Program symbolic name = 
Enter the total number of: 



PCCU macro 

DIA.LSEr macros 

3R0UP macros 

LINE macros with DIf\L=NO 

LINE macros with DIAL=YES 

rERMINAL macros not followed by a COMp macro 

(not a 2980) 

TERMINAL macros followed by a COMP macro 

lERMIN^kL macros for a 2980 

VTERyi macros 

C0?4P macros 

INNODE macros 

LLI macros 

CLUSTER macros for clusters on non-SDLC lines 

CLUSTER macros for clusters on SDL" lines 

Value specified in LUPOOL macro 

PU macros on SDLC dial lines 



1 X 


256 


= 


X 


80 


- 


X 


92 


~ 


X 


116 


- 


X 


160 


— 


X 

X 


212 

424 


- 


X 


U2U 


= 


X 


212 


::: 


X 


212 


- 


X 


160 


- 


X 


176 


- 


X 


96 


= 


X 


148 


= 


X 

X 


84 
84 


— 



256 



Unique VIDLIST macros referred to by a VIDSEQ 
parameter on a GROUP, LINE, or TERVUNAL macro 

VID3EQ parameters specified on all referenced 
VIDLIsr macros 

TERVIINAL macros that specify DIALNO= and that are on 
a 3R0UP or LINE macro that specified DI?;lL=YES and 
DIft.LSET= 

LCPYPE parameters specified on all unique MTALIST 
macros referenced by a GROUP or LINE macro + 1 

Poll cnaracters specified on the POLL parameter of 
all TERMINAL and COMP macros and the GPOLL parameter 
of the CLUSTER macro 

Dial digits specified on the DIA.LNO parameter of all 
TERMINAL macros where the LINE or 3R0UP macro 
specified CALL=0UT or INOUT 
BHSET macros 



8 = 



5 = 



5 = 



RDT si2a for 370x subarea = SUM A rounded up to a 
multiple of 2048 if SUM A is greater than 2048; 
otherwise, enter SUM A 



SUM A = 
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Work Sheet D2.2 - Calculation of the RDT for a 3270 LOCAL Subarea 

rhis calculation nnust be done for every 3270 LOCAL suoarea tnat will be activated in tfie 
vrAM network. The variable was determined for i^ork Sheet Dl.2. 

Syoibolic name = 

Enter nunfioer of LOCAL statements x 296 = 

+ 152 

SUM A - 

RDT value for LOCAL subarea = SUM A rounded up to a 
multiple of 2048 if SUM A is greater than 2048; 
otherwise, enter SUM A 



Work Sheet D2.3 - Calculation of the RDT for an APPL Subarea 

This calculation must be done for every APPL subarea that will be active in the VTAM 
network. The variable can be taken from Work Sheet Dl.3. 

Enter number of APPL statements x 12 = 

+ 152 

SUM A ^ 



RDT value for APPL node = SUM A rounded up to a 
multiple of 2048 if SUM A is greater than 2048; 
otherwise, enter SUM A 

Work Sheet D2.4 ~ Calculation of the RDT for a Switched Subarea 

This calculation must be done for every switcned subarea that will be activated in tne 
VTAM network. The variables for this calculation can be taken from Work Sheet Dl.4. 

Enter the number of: 

Unique MAXNOs x 33 = 

Unique MAX3RPS 
VBUILD macros 
PU Tiacros 
LU macros 
PATH macros 



RDT value for a switched subarea = SUM A rounded up to 
a multiple of 2048 if SUM A is greater tnan 2048; 
otherwise, enter SUM A 



X 8 


= 




x 156 


= 




X 148 


= 




X 176 


= 




X 8 




+ 152 


SUM A 


= 
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Work Sheet D2.5 - Calculation of the RDT for a 3790 LOCAL Subarea 

riiis calculation must be done for every 3790 subarea that will be activated in the vr^M 
networlc. The variable can be taken from Work Sheet Dl.5. 



Enter the number of: 

7BUILD macros 
PU macros 
LU macros 



RDT value for a 3790 subarea = SUyi h rounded up to a 
multiple of 2048 if SUM h is greater than 2048; 
otherwise, enter SUM h 



Work Sheet D3 - Calculation of SRTADD 



K 144 = 
X 236 = 
X 176 = 

SUM A = 



152 



Tnis area is the part of VPBUF needed for the symbol resolution table (SRD directory 
ana the SRT entries. The information needed for this work sheet can be taken from 
■/Jork Sheets Dl.l through Dl.5. 

Enter the total number of names specified in the name 
fields of the following macros: 

PCCru Tiacros 

DI^LSET macros 

3R0UP macros 

LINE macros (both dial and non-dial lines) 

TERMINA.L macros (all types of terminals) 

VTERiyi macros 

COVIP macros 

INNODE macros 

LU macros 

CLUSTER and PU macros ~ 

BSSET macros 

LOC?\L statements 

A.PPL statements 

VBUILD statements 

LBUILD statements 



SUM A = 



48 



6144 



SRTADD size = 
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Work Sheet D4 - Calculation for PSSWKA 

This area is the part of VPBUF needed for PSS control blocks. 
Enter iiaximum number of concurrent application tasks 
If NErSOL=YES is specified, enter 1; otherwise, 

PSSWK?^ size = 



X 912 



Work Sheet D5 - Calculation of OPNCLS 



This area is the part of VPBUF needed for VTAM control blocks to support OPNDST 
processing. Estimate a worst case condition for the number of concurrent OPNDSTs (that 
is, a combination of various types of OPNDSrs that requires the most storage) . Using the 
worst case estimate will allow adequate VPBUF space for processing of any combination of 
OPNDSr nacro instructions. 



Enter the maximum of concurrent OPNDSr naacros 

Of the concurrent OPNDST macros, enter: 

Number of NIB list entries if there is more than one 
NIB in the list 



Of the concurrent OPNDST macros, enter 
total size of LOGON data 

Of the concurrent OPNDST macros, enter 
number of logical units (LUs) 



OPNCLS size = 



912 = 



16 = 



16 



SUM B = 



56 = 



+106U8 



Work Sheet D6 - Calculation for OPNAPPL 



This area is the part of VPBUF needed for VTAM control blocks to support application 

programs. 

Enter maximum number of OPEN A.CBS that will be in the 

VTANl system 

If NETSOL=YES is specified, enter 1; otherwise, 



SUM h = 



X 608 

+ 376 



OPNAPPL size = 
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Work Sheet D7 - Calculation for VARY 



Enter riu:nber of PU statements with IsrA.rus=?i.criVE 



X 4656 = 



Work Sheet C3 - DOS/VS Storage Pool Formulas for bth, bno, and bsz 



• Formulas for bth calculation 

APBUF: LNlLU + NSSTERM+NBSCrERM+NLOC3270 + 5 

LPSaFl: NPORT+(2*NSDLCCL[JS) + (2*NLDC3790+ lSICOMMANDS + NLOC3270 +l^BSCCLUS 

NPBJF: IS!370X+NPORr+NLU+NBSCCLUS+NL3C3270+ NSDLCCLUS + NLOC3790 
(See Note 1) 

PPBaF2: (NLQ+NSSTERM+WBSCTERM+NLOC3270)*2 
(see Note 2) 

SPBUF: NPORT+ (2 + NSSTERM) + O + NBSCIERiVi) + (2*NLOC3270) +NBSCCLUS+ (2*NLU) + 
(4*NTRANX)+NrOLrEP + NSDLCCLU3+ NLOC3790 + NACB+NCOMiyiANDS 

^PBUF: NLU+NSSTERM+NBSCTERM+NLOC3270+ (2+NTR?^CE) 

SFBUF: 1 

LFBJF: / NrRANK*NBUFMSG\+/NTR?^NX+y[?^X&FR[J+2MAXBFRu\+/'NrRAi>iX*iyiAXBFRU+2!«AXBFRu\ + l 

\ L3270 / \ L3790 L3790 L3790 / \l370x L370x L370x / 

• Fomulas for bno and bsz Calculation 

r T T T T T T T T 1 

I 1 AP I LP I NP I PP I SP I WP I SF I LF | 

|.___| 1 1 ^ ^ 1 ^ ^ ^ 

1 bno 1 bth I bth j bth | bth | bth | bth | 1 | bth+2*/2;MA.XBFRU + 2iyiAXBRFU+NBUf MSG \ | 

j i 1 I I |.90 I I I V L370X L3790 / | 

|. 1_„__^ 1 1 ^ 1 1 1 _ ^ 

I bsz I 48 I 608 I 264 |LFBUF|104 |264 | - | see "Formulas for LBBUF osz Calculation" | 

I I I I I 13SZ I I i I I 

L X J. X i i X X X J 
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Variables for F ornnulas 

NBSCTERVl - Number of remotely attached terminals on BSC lines (number of TERMINAL and 
COMPONENT macros associated witti BSC lines). 

NBSCCLJS - Number of remotely attached 3271, 3275, and 2972 clusters on BSC lines. 

NLOC3270 - Number Of locally attached 3270 terminals (count eacn printer and display 
station separately) . 

NLU - Number of logical units (numoer of LU macros). 

NPORT - Number of dial-up switched lines. 

MAXEFRQ - Parameter specified on 370x and 3790 definition decks. 

2MAXBFRU means the sum of all values if tnere is more than one local 370x or 
3790 active. 

NBUFMS3 - Number of elements required to read the full screen of a 3277 display 

station. Use LFBUF bsz value (from i^rork Sheet Dl.l) to select NBUFMS3 from 
one of the following tivo tables. Index into the table to the bsz value 
closest to the LFBUF bsz. 



r T 1 

I Read Full, 3277 Model l|Read Full, 3277 Model 2 | 
j. ^ ^ ^ ^ 

[bsz value | NBUFMSG | bsz value | NBUFMSG | 

i. 1 1 1 ^ 



96 


16 


216 


8 


632 


U 


960 


2 


952 


1 



I 104 I *» I 96 I 16 I 

I 256 J 2 I 216 I 8 | 

1 632 

I 

I 

L X J. i ; J 

If both Models 1 and 2 are attached, use the Model 2 table. 

NSDLCCLUS- Number of remotely attached cluster controllers on SDLC lines. 

NSSTERM - Number of remotely attached terminals on start-stop lines (number of rERMINR.L 
and COMPONENT macros associated with start-stop lines) . 

NTOLTEP - Number of concurrent TOLTEP users. 

NTRANX - Number of transactions per second (where a transaction is one inbound message 
and one outbound message) - oetween the host and the involved devices. 

N370x - Number of IBM 3704 and 3705 locally or remotely attached communications 
controllers, 

NETSOL - 1 if NETSOL=ZES, Otherwise 0. 

NTR?^CE - Number of terminals or LUs for which a VTAM buffer trace (TYPE=B[JF) will be 
started. 

NLOC3790 - Number of channels for locally attached 3790 (PU macros for 3790s). 

NA.CB - Number of OPEN ACBs, 

NCOMMANDS- Number of concurrent operator commands. 

Note 1 - There could be hidden levels as in a vary act, tns NCP wnich also activates 
all devices with ISTATUS ACTIVE. 

Note 2 - Two represents the default BUFLIM, BUFACT product. For oaten this number 
could be low. The formula can be replaced by the sum of all the BUFACT * 
BUFLIM products. 
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Fonnulas for LFBUF bsz Calciil«tk» 



Dependiag on the installation's device usage, choose an initial bsz from the following 
overview. 



bsz = 
LF 



i Device Support 



jbsz Calculation 



|. + _ ^ 



Local 3270 | If the installation contains only local 3270s, calculate 

1 bsz as the average message length for 3277 display 
1 stations. 

J _ _^ _ 


.| _ — _« 

370x |bsz must equal the ONITSZ operarid on tne NCP HOST macro. 

1 If multiple N2Ps are active concurrently, Ut^JITSZ must nave 

1 the same value for each WCP. 

_ J ^^ _ 


— f — — - — -^ — 

3790 local only. Large | bsz = 1978 
batch transmission only. | 

1 MAXBFRU = 1 

1 3790L 

x_ ^ _^ _i_ 


^_ — — — __ -i_ 

3790 local only. Normal | bsz = 288 
transmission. j 

i MAXBFRU = 1 

1 3290L 

J. ^ -__^_ _ 


_ ^ _ — — — 

If priority is assigned to a|bsz = 370x bsz 
370x which is used with a | 
3790 local. | 

/Jith 370x given priority, | MAXBFRU = 1 for normal transmission 

3790 large batch perf orraancej 3790L 

may be less efficient | 

because of multiple buffer j MAXBFRU = 1978 divided by (bsz -28) 

usage, and the 3790 may use | 3790L 

more storage than necessary | 

because of the priority been j rounded up to a whole number for large batch 

given to the 370x. | transmission. 

^ X . - - _ _ 


« ^ — » -. — _ _ 

If priority is assigned to a] bsz = 1978 for large batch transmission. 

3790 local which is used j 

with a 370x. jbsz = 288 for normal transmission. 

priority, 370x buffers may | 3790L 
not optimize storage, | 



L X . - J 
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Constant requirement 

NETSOL (NETSOL=NO) 

SYSALOAD (from »S.B1) 

SMSBUF (from ^^S.B3) 

TOLrWKA. (zero TOLTEP user»l 

IsrPft.rCH (IBM-supplied patch area was not nodified) 

FIXPOOLS (from WS.BU) 

lOAPPN (from WS.B2) 

PA3P00LS (from /7S.B5) 

VT^yi Virtual Partition Si«e 

ALLOC = SUM A. divided by 1024, rounded up 



698368 



256 

38U 

g 

128 

2944 

5760 

-^9632 

SUM h = 777472 

760K 



Figure 22-4, Sample Calculation for ALLOC Macro Instruction 



Constant requirement 

ISTPAICH (IBM-supplied patch area was not modified) 

FIXPOOLS (from WS.B4) 

lOAPPN (from WS.B2) 

VTAM Real Partition Size 

(rounded up to a multiple of 2048) 

ALLOCR = SUM B divided by 102*, rounded up 



_l!i336 

128 

2944 

5760 

SUM A = _23168 
SUM B = 124576 

24K 



Figure 22-5. Sample Calculation for ALLOCR Macro Instruction 
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VTAM Components 

Core_l2ac[e_Librari^_Rec[uirements 

r T ^ 

I Ptiases I Blocks 1 

,- + ^ 

I I 181 1 796 I 

I I 15* I 16 I 

■ L X J 

+ transients 

Pnases 
isTM::rR 

ISTAICPr 

IISTAICTN 
ISTAICST 

ISTA.PC33 
ISrA.PC35 
ISTAPC36 
lSThUCA2 
ISThUCkT 
ISTCRCRU 
ISTCSCJ4R 

isroccoo 

ISTDCC02 

isrDccio 

ISTDCCll 
ISrDCC12 
ISTDCC:13 

isrbc32o 

ISTDCC:21 
ISrDC222 
ISTDCC23 

isrDcc:2ti 

ISTDCC25 
ISTDCCSO 
ISTDCC31i 
ISrDCC32 
ISTDCC35 
ISrDCCUO 
ISTDCC:41 
ISrDCCl|2 
ISTDCC50 
ISTDCCBl 
ISTDCC60 

i5rDc::6i 

ISTDC280 
ISTDCCSl 
ISTDCC85 
ISTDVCB?^ 
ISTDVCRC 
ISTESCOl 
ISTESC02 
ISTINCDP 
I ISTINCDT 
ISTINCFE 
ISriNCFO 
ISriNCFl 

isriNcip 

I ISTINCLM 

ISTINCMS 
I ISTINCN2 

ISTINCVr 
ISTINCXM 



isriNczi 

ISTINCZ2 

ISrMMCHS 
ISTNMCC?^ 
ISTNMCCB 
ISTNMCCF 
ISTNMCCI 
ISTNMCCO 
ISTNMCCR 
ISTNMCCS 
ISTNMCCr 
ISTNMCCZ 
ISTNMCIS 
ISTNMC2S 
ISTNM23S 
ISTNMC4P 
ISTNMCllS 
ISTNMCSP 
ISTNMC53 
ISTNMCSP 
ISTNMC6S 
ISTNMCTP 
ISTNMC7S 
ISTNMC8P 
ISTNMC9P 
ISTNSCOO 
ISTOCCCA 
ISTOCCCB 
ISTOCCCD 
ISTOCCDF 
ISTOCCOA 
ISTOCCOB 
ISTOCCRI 
ISTOCCS^ 
ISrOLTEP 
ISTORCBP 
ISTORCGS 
ISTPATCtJ 
ISTPICBA 
ISTPICCE 
ISTPICCF 
ISTPICCI 
ISTPICCO 
ISTPICCS 

isTPiccr 

ISTPICCU 
ISTPICDD 
ISTPICDR 
ISTPICGI 
ISTPICGP 
ISTPICGR 
ISTPICIN 

isTPicir 

ISTPICLA. 
ISTPICLC 
ISTPICLT 
ISTPICMA 
ISTPICQP 
ISTPICSC 
ISTPICSO 
ISTPICSS 
ISTPI2ST 
ISTPICSU 
ISTPICTF 
ISTPICTH 
ISTPICTO 
ISTPICTR 
ISTPICX?^ 
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ISTPICXF 
ISTPICXI 
ISrPICXL 
ISTPICXO 
ISTPICXI 
ISTPICX2 

isrpicxs 

ISTPIEBI 
ISTPIEBO 

ISTPIECP 
ISTPIEIF 
ISTPIEIR 
ISIPIEIS 
ISTPIELF 
ISIPIELO 
ISTPIELS 
ISTPIEPA. 
ISTPIEPB 
ISTPIEEC 
ISTPIERF 
ISTPIERO 
ISrPIESA 
ISTPIESG 
ISTPIESI 
ISTRACiCh 
ISTRACCR 
ISIRACTB 
ISTRACrM 
ISTRA.EL3 
ISTECCYO 
ISrRCC21 
ISTRCC22 

isrRcc;23 

XSTRCC26 
ISTRCC30 
ISTRCC51 
IsrRCC52 
ISTRCC53 
ISrRCC54 
ISTRCCeS 
ISrRCC65 
ISTRCC80 
ISIRCCBl 



ISTSC034 

ISTSDCAL 
ISTSDCCA 
ISTSDCCD 
ISTSDCCF 
ISTSDCCN 
ISTSDCCR 
ISTSDCOD 
ISrSECOl 
ISTSE210 
ISi'SEC21 
ISTSEC30 
ISTSEC40 
ISTSEC51 
ISTI^CLUS 
ISTI^CONI 
ISTYPSOL 
ISTlfSSCP 

Y^AM 2£ace 

PDAID^^TP 
PD?^IDVTW 



Zil§.Il§i§Ilt.S 

$$ABERV1 
$$ABERV2 
$$ABERV3 
$$ABERV4 

I $$ABE£V5 
$$ABERV6 

I $$ABEEV7 

$$Bcsroi 

$$BCST02 
$$BOST01 
$$BOST02 
$$BSTCNL 

$$bstc:ni 

$$RASrl4 
$$RAST15 
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Relocatable Librar^^R equ irements 



Modules 



Blocks 



504 



4,636 



Module 
Name 



Descriptions 



IJBESMRN 
IJBE7RN5 
IJBE3705 

ISTAICIR 
ISThlCPT 
ISTAPCAS 
ISTAPCSa 
ISTAPCST 
ISTAPC33 
ISrAPC35 
ISTAPC36 

isrAacAs 
rsTAacAr 
isrccoio 

ISTCCOll 

isrccoi2 

ISTCC013 

isrccolu 

ISTCC015 

isrccoie 

ISTCFCCE 
ISTCFCCS 
ISTCFCDP 
ISrCFCIN 
ISTCFCiVlM 
ISTCFCPC 
ISTCFCPO 
ISrCFCRP 
ISTCFCRl 
ISTCFCR2 
ISTCF3SS 

isrcFcsw 
isrcFcsi 

ISTCFCS2 
ISTCFCTM 

isrcFcxs 

ISTCRCR4 

isrcscAc 

ISTCSCA2 

isrcsccL 

ISTCSCL3 
ISrCSCMR 
ISTCSCPS 
ISrCSCRL 
ISTDCCOO 
ISrDCC02 
ISTDCCIO 

isrDccii 

ISTDCC12 
ISrDCC13 
ISrDCC20 
ISrDCC21 
ISTD2C22 
ISrDCC23 



Summarize 3705 MDR Records 

Edit and Print 3705 MDR Records 

Edit and Print Page Header for 3705 MDC Recoris 

API Check Routine 

API Interface Routine 

User Completion 

PSS Scheduler 

PSS Macro Services Routine 

PSS-TPIO specifics - asynchronous process routine 

PSS TPUNLOCK 

PSS TPLOCK - Shared 

PSS TPLOCK - Exclusive 

Accounting Exit Routine 

Authorization Exit Routine 

rOLTEP - OLT Scheduler 

rOLTEP - Message I/O 

rOLTEP - Trace Return Code Handler 

TOLTEP - Loader 

rOLTEP - Resource Manager 

TOLTEP - Table Search Routine 

TOLTEP - READ/WRITE Exit 

System Writer Channel Appendage 

Operator Control Command Processor 

CTLPT - Display Command 

Operator Control Initialization 

Message CSECT 

POI Termination Routine 

POI Initialization Routine 

POI Reply Processor 

RCVCMD Processor 

POI Message Build and Purge Routine 

System Writer SVC 

System Writer I/O Process 

SENDCMD Router 

POI Vary, Display, and Modify Processor 

TPMSG Macro Handler 

STXIT OC for System Writer 

Feedback Routine 

Accept 

Acquire 

Cancel 

Logon 

Master Router 

Pass 

Release 

Request Start 

Request Finish 

Solicit LDO Request Processor 

Read LDO Request Processor 

Write LDO Request Processor 

Reset LDO Request Processor 

Solicit Macro Request Processor 

Receive Macro Request Processor 

Write Macro Request Processor 

Reset Macro Request Processor 
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Module 
Name 



Descriptions 



IsrDCC24 
ISTDCC25 
ISTDCCSO 
ISTDCC31 
ISTDCC32 
ISTDCC35 
ISrDCC40 
ISTDC241 

isrDcc;42 

ISTDCC50 

isrDccsi 

ISTDCC60 
ISrDCC61 
ISTDCC80 
ISTDCCBl 
ISTDCC85 
ISrOVCBA 
ISTDVCRC 
ISPECOOO 
ISTEC123 
ISrECU56 
ISTEC789 
ISTESCOl 
ISTESC02 

isricooo 

ISTICOOl 
ISTIC002 

isric:003 
isric:004 

ISTIC005 
ISriNCAD 
ISTIl^CAL 
ISTINCAV 
ISTINCZ^W 

isriNC?5tO 

ISTIW2BL 
ISriNCBS 
ISTINCCC 
ISriNCCF 
ISTICJCCL 
ISriNCDL 
ISTIMCDP 
ISTINCDT 
ISTINCDO 
ISTINCDO 
ISTINCD1 
ISTINCD2 
ISTINCD3 
ISTINCDU 
ISTINCD5 
ISTINCD6 
ISTINCD7 
ISTINCD8 
ISTINCD9 
ISTINCEO 
ISTINCE1 
ISTINCE2 
ISTINCE3 
ISTINCEt* 
ISTINCE5 
ISTINCE6 
ISTINCE7 
ISTINCE8 
ISTINCE9 



Solicit All LVlacro Request Processors 

Read Any Macro Processor 

Feedback Start 

Analyzer 

Feedback Finish 

Pageable Extension of Feedback Start 

Solicit and Read LDO Feedback 

v^rite LDO Feedback 

Reset LDO Feedback 

Solicit, Read, 4rite Feedback 

Reset Feedback 

Input Buffer Move 

Fixed to Pageable Move 

Purge Outbound 

Purge Inbound 

Read Any Purge 

Skeleton Dvr for Basic 

skeleton DVT for Record 

rOLTEP - End of fOLTEP 

rOLTEP Message tlt%% (100-399) 

rOLTEP Message jmm:. (400-699) 

TOLTEP Message f6Jtt (700-999) 

Execution sequence Controller 

DVT Name Resoliition 

TOLTEP - Resident Exit Initialize 

TOLTEP - Test Initialize 

TOLTEP - Communication Interval 

TOLTEP - Device Decode 

TOLTEP - Test Decode 

TOLTEP - Option Decode 

ADELETE Service Routine 

ALOAD service 

Allocate/Dealloaate Subroutine 

VTAM Task Control 

Subtask ATTACH 

BLDL Routine 

SVC Bootstrap Routine 

Start command Processor 

Loading Routin-e 

Error Recovery Processor 

Dump/Load Restart 

Dump/Load Subtask 

Default USS Defiiition Table 

DVT Unload 

Subtask Detach 

Dial Out Processor 

Dial Failed Processor 

Offhook 1 

Select Path 

Dial Link Start 

Dial Allocate 

Dial Deallocate 

Dial Post 

Offhook 2 

Dial Out Start 

Link Restart 1/0 

PAB Switch I/O 

PU Cleanup 

Link Restart 

Dial Give Resources 

Dial Hangup 

Inop Processor 

Dial Link Completion 

Potential Tailor* 
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Module 
Name 



-+■ 



Descriptions 



ISTINCFE 
ISTINCFM 
ISTINCFS 
ISTINCFO 
ISTINCFl 
ISTINCF3 
ISTINCF4 
ISTINCFS 
ISTINCF9 
ISriNCBA 
ISTINCHr 

isnisiciB 

ISTINCIO 

isriNcip 

ISTINCir 
ISriNCLF 
ISTinCLB 
ISTINCLO 
ISTINCL1 
ISTINCL2 
ISTINCL3 
ISTINCm 
ISTINCL5 
ISTINCL6 
ISTINCL7 
ISTINCL8 
ISTINCMD 
ISTIMZMR 
ISriNCMS 
ISTIWCMY 
ISriNCNS 
ISTIl^CNO 
ISriNCN2 
ISTINCN8 
ISTINCOC 
ISTINCOE 
ISTIl^COI 
ISriNCOQ 
ISTINCOS 
ISriNCPD 
ISTINCPH 
ISTINCQB 
ISTINC2E 
ISriNCRD 
ISTIMCRF 
ISTINCRP 
ISTINCRR 
ISriNCRS 
ISTINCRl 
ISTINCR2 
ISTINCRB 
ISTINCR4 
ISTINCR5 
ISriNCR6 
ISTINCrSD 
ISTINCSH 
ISTINCSM 
ISTINCS1 
ISTINCTE 
ISTINCTM 
ISTINCTE 
ISTINCOA 
ISTINCUB 
ISTINCOM 



Front End Processor 

FSS Function Manager 

Segment Deletion 

Fixed Module Linkage 

FSS Bequest/Response Construction 

Init SELF Processor 

TEHM SELF Processor 

Stop, Modify CIB Processor 

Stop/Modify Processor 

Host Attactiment Routine 

Halt Command Processor 

srAE Routine 

I/O Command Scheduler 

SCP Inbound Processor 

Initialization Control 

Logon Processor 

Default Logon Mode Table 

Activate Direct Attachment Node 

Activate PU - Local Subarea 

Local Attach - Dial Start 

Local Attach - Offhook 1 

Local Attach - Offhook 2 

Local Attach - Dial Failed 

Local PU Cleanup 

Local Abandon Connection 

Deactivate Direct Attachment Node 

Modify Router 

Master Router- 

rOLTEP/VTAM Interface 

OSS Portion of SSCP Master Router 

Network Solicitor Attach 

DTP Builder 

Device Allocation SVC 

Activate Reserved 

TERM NOP 

Operator Termination 

Operator Task Initialization 

Operator Query 

Optional Services Routine 

Buffer Pool Initialization 

Parameter Handling 

2AB Initialization 

Quiesce 

Parameter Read Routine 

Modify Command Router 

Communications Controller ERP Reload 

Resource Release 

Read Record 

Configuration Restart Control 

Configuration Restart/Vary Interface 

NCP Configuration Reset 

VSAM I/O C/R Data Set 

Interface to DLR 

VSAM I/0-Active NODELST Data Set 

Task Communication Routine 

Search Logon Mode Table 

SSCP Session Monitor 

Status Feedback Router 

TPEND Exit Scheduler 

Timer Routine 

Trace Control 

Verb and Keyword Processor II 

Verb and Keyword Processor III 

USS Function Manager 
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ModulE 
Name 



Descriptions 



ISTINCUQ 
ISTINCUO 
ISTINCU1 
ISTINCU2 
ISTINCU3 
ISTINCU4 
ISTINCU5 
ISTINCU6 
ISTINCU7 
ISTINCaS 

isriNCv/A 

ISTINCVI 

isriNcvisj 
isriL^2vo 
isriN::\/p 

ISTIt^ZVS 
ISTINCV/K 
ISTIMCVl 
ISTINCV2 
ISTINCV3 
ISTINCVa 
ISTINCV5 
ISTINCV6 
ISTINCV8 
ISTINCV9 
ISTINCWT 
ISTINCWO 
ISTINCW1 
ISTINCW2 
ISTINCW3 
ISTINCW4 
ISTINCS5 
ISTINCH6 
ISTINCH7 
ISTINCW8 
ISTINCW9 
ISTINCXM 
ISTINCXO 
ISTINCXl 
ISTINCX2 
ISTINCX3 
ISTINCX6 
ISTINCX7 
IS1INCX8 
ISTINCX9 
ISTINCYO 
ISTINCYI 
ISTINCy3 
ISTINCY4 
ISTINCY5 
ISTIC^CZl 
ISriNCZ2 
ISTINCOl 

isriNc:02 

ISTIl^COS 

isnisicos 

ISTINC06 
IsriNC07 
ISTI1^C32 



USS Quota Deletion 

Input Media Control 

SCS Input Media Control 

USS Character String Translation 

Verb and Keyword Processor I 

USS Logon Processor 

USS Logoff Processor 

USS Status Feedback Processor 

3270 Output Media Control 

USS Output Media Control Processor 

Vary (Activate 

Vary Deactivate 

RNAME/CQA Processor 

Vary Session Initialization 

Vary Deactivate Phase II 

Vary Activate Extension 

Vary Deactivate 

vrAMRP Task 

Answer Mode Handler 

VARY INOP Command Processor 

Activate PU Switched Subarea 

Activate LU Switched Subarea 

SEND/SEND FMD Processor 

IPL/DDMP Processor 

Contact/Discontact Processor 

VTAM Thread Dispatcher 

OPNDST Processor 

TOLTEP Attach and NETSOL Delete 

Hang-up I/O 

Obtain/Free NCSPL 

Contact Processor 

Discontact Processor 

Vary Pending Cleanup 

Build PABs 

Activate PU and LU 

VARY Path Processor 

3704/3705 Dump I/O Routine 

Deactivate Switched SDLC Links 

Deactivate Switched and Local PU 

Break Connections 

Switched/Local Header Deactivation 

Dial Fail Notify 

DACTPU Handler 

PAB Purge 

CLSDST Handler 

APUNS Command Processor 

APUNS Transmission Services I/O Executor 

APUNS Command Completion Processor 

RTGOH Request Processor 

Disconnection Processor 

DTFSF 

DTFDA 

Load Utility Message and End 

DVr Preload Routine 

Communications Controller Load Input 

Communications Controller Load Initialization 

Load Utility Common Storage Area 

Communications Controller Load Output 

Communications Controller Load Output 
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Module 
Name 



Descriptions 



ISriNEXI 
ISTLINKl 
ISrLINK2 
ISTLINK3 
ISTLINK4 
ISTLIMK5 
ISrLINK6 
ISTLINK7 
ISTLINK8 

isrwyicHs 

IST1^I^1CC^ 
ISrNXICCB 
ISTNMC^F 

isrNyicci 

ISTISTMCCIO 

isrNMcrcR 

ISTiNlMCCS 

isrNMCcr 

ISTNMCCZ 

isrNMCis 

ISTi^vi22S 

isr^yicBs 

ISTNyiCMP 
ISINMCtS 
ISTNM25P 
ISTN?4C55 
ISTNM26P 
IsrNMC6S 
ISTtNiMC7P 
ISTNMCVS 
ISTNMCSP 
ISTN?4C9P 
ISTNSCOO 
ISTOCCCR. 
IST0CC2B 

isrocccc 

ISTOCCCD 
ISTOCCCti 
ISTOCCCL 

isrocccyi 

ISTOCCCN 

isroccDF 

ISTOCCIFB 

isroccFD 

ISTOCCFO 

isroccFR 

ISTOCCLD 
ISTOCCMD 
ISTOCCNV 
ISTOCCOA 
ISTOCZOB 

isroccoc 
isTOc::oD 

ISTOCCOE 
ISTOCCDF 

isrocc2u 

ISTOCCRD 
ISrOCCRL 
ISTOC^Rr 
ISTOCCSA 
ISTOCCSD 

isroccsL 

ISTOCZUR 
ISTORCBP 



Link Scripts 



Network Control Program 

Control Block: Manipulation Routine 

Start Control Outbouni 

Start Control Inbound 

Start Control Failure 

Cluster Solicitor Inbound Router 

Cluster Solicitor Outbouni Router 

Redrive Outbound 

Redrive Inbound 

Start Control Redrive 

End Control Outbound 

Connection Complete 

Redrive PSOP 

DIAL Disconnect 

PSOP Router 

Purge 

Start control 

Port Solicitor 

Reset and Control Redrive 

Initial Contact Retry 

Start Input 

PSOP End Control 

Purge Outbound 

PSIP Router 

Network. Solicitor 

Close ACS Phase I 

close ACB Phase II 

Close ACB Phase III 

Closed DEB Interface Routine 

Change 

Close Destination Part I 

Close Destination Part II 

Close Destination Part III 

SRI Delete/Find 

Control Block Building 

Function Distribution 

Function Obtain 

Control Block Removal 

Logon Data Handler 

Master DVT Builder 

OPNDST - t^IB copy/Merge 

OPEN ACB Phase I 

OPEN ACB Phase II 

OPEN ACB Phase III 

OPENDSr and SIMLOGON Phase I 

OPNDST Phase 2 

OPNDSr and SIMLOGON Final Phase 

SEILOGON 

Real DVT Builder 

Function Release 

Routing 

SRI Add 

Skeleton DVr Reader 

Function Select 

Routing End 

Build Pool Routine 
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Module 
Name 



Descriptions 



IST0RC3S 
ISrORCRQ 
ISrORCRT 

isrPArcB 

ISTPICBA. 
ISTPICCA 
ISTPICCE 

isrpiccF 

ISTPICCI 
ISTPICCO 
ISTPICCS 

isrpiccr 

ISTPICCU 
ISrPICDD 
ISTPICDR 
ISTPICEI 
ISTPICES 
ISTPICFI 

isrpicsi 

ISTPIC3P 
ISTPICSR 
ISTPI2IN 

isrpicir 

ISTPICLA 

isrpicLc 

ISTPICLr 

isrpicMA 

ISTPICNR 

isrpicQP 

ISTPICRI 

isrpiCRP 

ISTPICSC 
ISTPICSO 
ISTPICSS 

isrpicsr 

ISTPICSU 

isrpicrF 

ISTPICrH 

isTPicro 

ISTPICTR 
ISTPICX?^ 
ISTPICXF 
ISTPICXI 
ISTPICXL 
ISTPICXP 
ISTPICXO 

isrpicxi 
isrpicx2 
isTPicxe 

ISTPIEBI 
ISTPIEBO 

ISTPIE2P 
ISTPIEIF 
ISTPIEIR 
ISTPIEIS 
ISTPIELF 
ISrPIELO 
ISTPIELS 

isrpiEPA 

ISTPIEPB 
ISTPIEBC 
ISrPIERF 
ISTPIERO 
ISTPIES?^ 



Request/Release Storage 

Request Buffers 

Return Storage 

VrAM Patcti Area 

Dial-in Analyzer 

ATTN/READ Handler (Local 3270) 

Local 3270 Analyzer 

Control Command Analyzer 

Channel End Appendage CLocal 3270) 

Control Command Interpreter 

Command Scheduler 

Remote Command Updater 

Remote 3270 Command Updater 

Disconnect Handler 

eru Analyzer 

ERP/VARY Interface 

Error Statistics Collection (Local Devices) 

Feedback Initiation 

General Interpreter 

General Poll Analyzer 

General Response Interpreter 

BTU Builder 

Remote 3270 Command Interpreter 

Local 3270 TEST Command Analyzer 

Local 3270 TEST Command Analyzer 

Local Control Command Interpreter 

Dial-in Analyzer (Start-Stop) 

Unsolicited BTU Handler 

2ueue Purger 

FSB Build 

READ Channel Program Build 

Remote 3270 

Switched Outbound Scheduler 

Session Scneduler 

I/O Session Completion Processing 

Session Update 

Trace Handler (Feedback) 

TOLTEP TRM Handler 

Trace Handler (Outbound) 

LCCW to CCW Translator (Local 3270) 

Extension to ISTPIEGR 

Extension to ISTPIEGP 

CZ channel Program Initialization 

Local 3270 Channel Program Initiation 

Channel Program Initiation 

Extension to ISTIEGl 

Extension to ISTIET 

Extension to ISTPIECS 

Extension to ISTPIEDR 

Buffer Trace Inbound Eouter 

Buffer Trace Outbound Eouter 

Unsolicited Input 

DOS/VS Transmission services Inbound Interface 

First Outbound FIDl 

SETL Outbound FIDl 

Local 3270 SR Feedback Processor 

Local 3270 SEND/RECEIVE Channel Program 

Local 3270 SR Session Control Interpreter 

First Inbound FIDl 

PIU Builder FIDl 

Record Mode Request Checker 

3270 Record Mode Response Analysis 

3270 Record Mode RU Builder 

SCTL Inbound FIDl 
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Module 
Name 

ISTPIESG 
ISTPIESI 

isrpiErr 

ISTRhZZh 
ISTRhCCR 
ISTR^CIB 
ISTRACIE 
ISTR^CTM 
ISTRACrO 
ISTRACrS 
ISTRACr/J 
ISTR^^ELG 
ISTECCYO 

isrRc:c2i 

ISTRCC22 
ISrRCC23 

isTRc:::26 

ISrRCC30 
ISTRC:::51 
ISrRCC52 
ISTRC:253 
ISrRCC54 
ISTRC263 
ISrRCC65 
ISTRCCSO 
ISTRCCSl 
ISTSC02A 
ISTSC02B 
ISTSC02C 
ISTSC02D 
ISTSC02E 
I5TSC02F 
ISTSC020 
ISTSC:021 
ISTSC022 

isrsco23 

ISTSC024 

isrsco25 

ISTSC;026 
ISTSC027 
ISTSC028 
ISTSC:029 
ISTSCOSO 

isrsco3i 

ISTSC:032 

isrsco33 

ISTS3034 

istsdcal 
istsd::?\p 

ISTSDCBa 
ISTSDCCA 
ISrSDCCB 
ISTSDCCD 
ISrSDCCF 
ISTSDCCL 
ISrSDCCN 
ISTSDCCR 

isrsDcci 
isrsDc:c2 

ISTSDCC3 
ISTSDCC4 
ISTSDCC5 
ISTSDCC7 
ISTSDCDS 



■!- 



Descriptions 

Inbound Segment Processor 

3270 Record System Control Interface 

TRACE Interface 

A.dd Service Routine 

Remove service Routine 

Buffer Trace Routine 

Trace Edit Control 

Main Trace Routine 

I/O 3uffer Edit 

Trace Edit Scan 

Trace /Writer 

Trace Log Module 

Control Layer EPL Direct Post Routine 

Receive Macro Request Processor 

SEND Macro Request Processor 

RESETSR Macro Request Processor 

Send Response 

Record Feedback Start 

RECEIVE 1 Feedback 

RECEIVE 2 Feedback 

SEND Feedback 

Asynchronous Feedback 

House Any Queues 

SET RPL 

Clear Outbound Processor 

Clear Inbound 

TOLTEP 3RAB 

TOLTEP LETGO 

TOLTEP MORECORE 

TOLTEP PLINK 

TOLTEP ROUTINE 

TOLTEP i>?AiriO 

TOLTEP-CECOM 

TOLTEP CONVERT 

TOLTEP $CarE3T 

TOLTEP $DDATE 

TOLTEP DPRINT 

TOLTEP SEND 

TOLTEP $DTIME 

TOLTEP EXIO 

TOLTEP FREECORE 

TOLTEP GETCONFG 

TOLTEP acquisition 

TOLTEP Release 

TOLTEP DIO 

TOLTEP Receive 

TOLTEP MS Inbound Process 

ALERT Macro Handler 

Application RDT 

BUILD Macro Handler 

CIDADD Macro Handler 

Control Block Definition 

CIDDEL Macro Handler 

CIDFND Macro Handler 

CLUSTER Macro Handler 

FIND NCB yiacro Handler 

CID, FINISH Macro 

System Definition Area Handler 

Error Message Formatter 

Macro Type Interpreter 

EBCDIC/Hex Conversion 

ADDBITS Routine 

^ork Area Handler 

DIALSET Macro Handler 
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I Module 



Name 



I Dascriptions 



ISTSDCDl 
ISrSDCD2 
ISTSDCD3 
ISrSDCSE 
ISTSDC3P 
ISTSDCtiS 
ISTSDCIrJ 
ISrSDCLM 
ISTSDCLN 
ISTSDCLP 
ISTSDCLU 
ISTSDCHL 
ISTSDCMT 
ISTSDCOD 
ISTSDCPA 
ISrSDCPC 
ISTSDCPO 
ISTSDCPl 
ISTSDCP2 

istsdc:p3 
istsdcpu 
isrsDCPS 

ISTSDCP6 
ISTSDCRC 
ISTSDCRN 
ISTSDCR3 
ISTSDCSB 

isrsD:rsc 

ISTSDCrM 
ISTSDCVB 
ISTSDCVG 

isrsDC\/i 

ISTSECOl 
ISTSECIO 
ISTSEC21 
ISTSECSO 
1ST3EZH0 
ISTSEC51 
ISTSQCOA 
ISTSQCOB 
ISTSQCOO 

isrsQCOi 

ISTS2C:02 
ISrSQC03 
ISTS3C04 

ISTS3C06 

isrs2::07 

ISTSQC08 

isrs2C09 
isrsfcoo 
isrrcoBS 

ISTTC037 

isrvrcoN 
isTvrcvr 

ISTVTLOD 
ISrYCLOS 
ISTYCONI 
iSI'j'PSOL 
ISTi'SSCP 



SRT Delete 

SNT Delete 

Interpret Table Load 

GENEL^D Macro Handler 

Group Macro Handler 

Host Macro Handler 

INNODE Macro Handler 

Task Switching Routine 

LINE Macro Handler 

LUPOOL Macro Handler 

LU Macro Handler 

WIALIsr Macro Handler 

MIALIsr Macro Handler 

Device Type Table 

Path Macro Handler 

PCCU Macro Handler 

PO Kacro Handler 

MTA.I1IST Parameter Handler 

LIST Parameter Handler 

\/IDSE2 Parameter Handler 

TERM Parameter Handler 

DIALSET Parameter Handler 

VP?^CIN3 Parameter 

System Definition Mainline 

2Z RDT Build 

Stiift/Def ault Entry Builder 

STA.RTBH Macro Handler 

Sl^SCNTRL Macro Handler 

Terminal Macro Handler 

VSBniLI) Macro Handler 

Switched/Local Skeleton Build 

VIDLIST Macro Handler 

Session Control Outbound Start 

Session Control Outbound Processing 

Session Control Feedback Processing 

Session Control Inbound Request Processing 

Session Control A.uto Response 

Session Control 2ueue Purge 

Inquire TOP Logon Processor 

Inquire SESPAIH Processor 

Inquire Parameter Validation 

Logon Data Routine 

Device Characteristics Routine 

Active Count Routine 

Terminal Routine 

A.pplication Status Routine 

Display Station Routine 

Communications Controller Name Routine 

CID Translation Routine 

Terminal Identification Routine 

Interpret Processor 

TOLTEP - DTERM 

TDLTEP - DUMP 

Storage for Configuration List 

Storage for DVT 

Module Load List 

Skeleton DVT for VP.RY (noa-3DLC Devices) 

Skeleton DVT for VARY (non-SDLC Devices) 

Skeleton DVT for Port Solicitor 

Skeleton DVT for SSCP 
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Transients 



Linjc-Ejiit Statements (VT?VM proper)_ 



$$?\BERy;i SDR Counter Update 

$$.^BERV2 OBR Record Builder 

$$ABER\/3 3705 ERP First Transient Load 

$$?lBERV4 Local 3270 ERP First Transient 

Load 
$$ABERV5 3791 Error Recovery Procedure 
$$ABEEV6 Local 3270 ERP Second Load 
$$ABERV7 3791 Statistical Data Recorder 

Extension 
$$BCsr01 Close ACB Transient 
$$BCST02 Close A.CB Transient, Return 

Linkage Routine 
$$BOSr01 Open hCB Transient 
$$BOsr02 Open A.CB Transient, Return 

Linkage Routine 
$$BSTCNL EOJ Transient 
$$BSTCN1 EOJ Transient, Return Linkage 

Routine 
$$RA.sri'+ 3705 Channel Check ERP 
$$RAsri5 Local 3270 Channel Check ERP 



// OPTION CATAL 

INCLQDE ISTLINKl 
// EXEC LNKEDT 

INCLUDE ISrLINK2 
// EXEC LNKEDT 

INCLUDE ISTLIWK3 
// EXEC LNKEDT 

INCLUDE ISTLINK4 
// EXEC LNKEDT 

INCLUDE ISTLINK5 
// EXEC LNKEDT 

INCLUDE ISTLINKS 
// EXEC LNKEDT 

INCLUDE ISTLINKS 
// EXEC LNKEDT 



Ensure that no 
private core image 
liorar/ is assigned 



Link-Edit Statements (Network Control 
Prog[ram)_ 

// OPTION CATAL 

INCLUDE ISTLINK? 
// EXEC LNKEDT 



LINKING VTAM 



S2!i££§_Stj.te[nent_L3^rajcY_Re2uiremen 



VTAM link-edit books ISTLINKl and 1STLINK8 
require operator response to // PAUSE 
statements when procedure LINKVTM is 
executed. ISTi^INKl may require a // LBLTVP 
NSD(xx) statement when it is included at 
link-edit time (this statement reserves 
label processing area space at the 
beginning of tne VTAM partition for the 
direct-access-formatted Network Control 
Program dump files) . 

If your VTAM network does not include a 
3705 (Network Control Program), an EOB 
operator response is all that is required. 
If, however, 3705 (Network Control Program) 
support is required, tne // LBLTYP 
statement must be entered at the console, 
in which case "xx" is to be replaced by a 
numeric value indicating the maximum numoer 
of disk file extents for a given Network 
Control Program dump file. 

If 3705 support is included later in 
your VIAM network, ISTLINKl must be 
relink-edited to reflect this change. 
ISTLINK8 must be cataloged into the system 
core image library; hence, the operator 
must ensure that SYSCLB is unassigned when 
ISTLINKS is included. This link-edit book 
includes VTAiyi modules and transients which 
may be fetched for a user partition 
whenever VTAM is operative in the system. 



Macros 



Blocks 



52 



5,492 



jVLacro, Names 

E . CHANGE 

E.CLSDST 

E.DO 

E.ENDINTAB 

E.EXECRPL 

E.IFGACB 

E.IFGEXLST 

E.IFGRPL 

E.IHBRDWRA 

E. INQUIRE 

E . INTAB 

E . INTRPRET 

E.ISTACB 

E.ISTACBG 

E.ISTAVT 

E.ISTBLDO 

E . ISTCBMTB 

E.ISTCBl 

E.ISTCB2 

E.ISTDBIND 

E.ISTDNIB 

E.ISTDPOHD 

E.ISTDPROC 

E.ISTDVCHR 

E . ISTEXLG 

E.ISTEXLST 



E.ISTRDvJRA 

E.ISTRPL 

E.ISTRPLG 

E.ISTUSFBC 

E.LDO 

E.LOGCHAR 

E.MODEEND 

E.MODEENT 

E.MODETAB 

E.NETSOL 

E.NIB 

E.OPNDST 

I E.RCVCHD 
E. RECEIVE 
E. RESET 
E-RESETSR 

I E.SENDCHD 
E.SESSIONC 
E.SETLOGON 
E.SIML030N 
E. SOLICIT 
E.USSCMD 
E.USSEND 
E.USSMSG 
E.USSPARM 
E.USSTAB 
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APPLIC?^riON PROGRAM STORAGE CONSIDERAPIOWS 

RPL Oriented Macro Instruction Storage 

VTAVL RPL oriented nnacro instructions call an inner macro instruction IriBKDrtRA to expand 
code to [Tiodify RPLs. The parameters listed below snow the minimum and maximuTi 
expansions. All para.neters, except ttie RPL parameter, are optional. 



r 


" 


^ ^ 


1 Parameter 
1 




1 Minimum Expansion) Maximum Expansion 

1 (bytes) i (bytes) 
± 1 


r 


' -— —— .— — — — ^^— ^^ — — — — — — — .^ — — — ^ — — ^ -^ ~w.m 


1 1 


|RPL 




1 1 12 


1 (If additional parameters are coded, include 




|8 bytes) 




1 8 I 8 


1 ACB 




1 14 1 b 


1 AREA 




1 4 1 8 


1 AREALEN 




! 4 1 16 


IRECLEN 




1 4 1 16 


1 AAREA 




1 4 [ b 


1 AAREALN 




1 4 1 16 


1 ARECLEN 




1 4 1 16 


|ECB+ 




1 16 1 20 


JEKir* 




1 16 1 20 


1 AR3++ 




1 8 1 & 


1 NIB*+ 




1 12 1 12 


1 OPTCD 




1 14 1 48 


JSYN or ASY 


subparameters 


1 '^ i ^ 


JSEQNO 




1 4 1 14 


[BRANCH 




1 *+ 1 4 


jlBSQVAL 




[ 4 1 14 


1 OBSQVAL 




1 4 1 14 


1 RESPOND 




1 4 1 12 


[CHAIN 




1 8 1 8 


[CONTROL 




[ 10 1 10 


[ CHNGDIR 




1 4 1 8 


[BRACKET 




1 '^ 1 8 


jSSENSEO 




1 '^ 1 ^ 


[USENSEO 




1 4 I 14 


1 SSENSyiO 




1 ^ i ^ 


[RTYPE 




1 4 1 16 


isTYPE 




1 '^ 1 ^ 


1 TBSQAC 




i ^1 ^ 


1 OBSQAC 




1 '^ 1 ^ 


[POST 




1 4 [ 4 


1 Macro exit 


code 


[ 14 1 14 


1 Space lost 


due to CNOP alignment 


I [ 2 



^ J. X ^ 

[* Mutually exclusive *♦ Mutually exclusive [ 

L J 



Since all parameters except the RPL parameter are optional, the minimum expansion for any 
RPL oriented macro instruction is 14 bytes. The maximum size of any RPL oriented macro 
instruction is 354 bytes. However, most macro instructions can be expected to use a 
subset of these parameters. Thus, as an aid to estimating tne size of these macro 
instructions in the user's partition, the following representative maximum expansion 
sizes are provided: 
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I Macro Instructioii 

CHAN3E 

CLSD3T 

DO 

INQUIRE 

INTRPRET 

OPNDST 

RECEIy/E 

RESET 

RESET3R 

SESSIONC 

SETL030N 

SIML03DN 

SOLICIT 



I Representative Maxinnunn ExpansioQ Sizes (oytes) 




^OD:trol_Bloclc__Storac|;e 

The following are the sizes of VTAM control blocks that are Duilt in tne user's 
partition: 



i2D:trol_Biock_Name 

ACB 
NIB 
RPL 
EXLST 



Sjizs (bytes) 
52 
100 



15 to 80 (depending on which exits are specified) 



!:4anipulative Macro Instruction Storage 

VTPlM Tianipulative macro instructions may be used to generate ''JTh'A control blocks or to 
modify various fields in these control blocks. v^hen the manipulative macro instructions 
are used, the user's application program partition must allow a 4K (4096 oyte) area to 
load the processing module, while allowing sufficient storage for the expansion of tne 
manipulative macro instructions. The following list snows tne minimum expansion sizes 
and a representative average expansion size of the manipulative macro instructions for 
each type of VTA.M control block. 



Macro 


1 Type of 


1 Minimum 


Expansion! Re 


presentative 


Average Expansion Size 


Instruction] C 


ontrol Bloc 


k| 


(bytes) 


1 




(oytes) 




1 




1 . 






1 






3ENCB 


1 

t 

1 

1 
[ 


ACB 
EXLST 
NIB 
RPL 


T 




54 
54 
54 
54 


T 

1 

1 

i 

1 
1 




94 
118 

78 
100 


MODCB 


1 
1 
1 
1 

! 
J 


ACB 
EXLST 
NIB 
RPL 


1 

1 




60 
66 
66 
60 


T 

1 

1 

1 

1 
1 




102 
98 
90 

100 


SHOi^CB 


1 

1 
1 

1 


ACB 
EXLST 
NIB 
RPL 


i 




66 

66 
66 
66 


t 

1 

1 

1 

1 
1 




104 

126 

96 

166 


TESTCB 


1 
! 

i 
1 
1 


ACB 
EXLST 
NIB 
RPL 


1 




66 
70 
70 
66 


t 
1 
1 
1 
1 




65 
70 
92 
70 



L X. X J. J 
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I Module 23: Subsystem Support Services ~ 5747-CC6 
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SUBSYSrEM_syPPORT_SERVICES 

IBH Subsystem Support Services (SSS) Bust be included in the relocatable library. The 
generation of active load nodules for SSS does not take place vith the DOS/VS system 
generation process. Instead, SSS is generated in a separate process, concurrent vith the 
generation of any of the following industry systems: 

IBM 3600 Finance Communication System 

IBM 3650 Retail Store System 

IBM 3660 Supermarket System 

IBM 3790 Commanication System 

This generation process and the virtual storage estimates for SSS in DOS/vs are 
documented in the I£fl filfitfil^Ufi Sil^§XSl&I £fl£C2C^ SSCX4££§ 2§§£l§ Guide, GC30-3022. 
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Module 24: System Utilities - 5745-SC-UTL 

- 5745-SC-UTS 

- 5745-SC-APC 



Module Outline 




general 351 

partition size 351 

analysis program-1 * 351 

core image library....... 351 

phase 351 

relocatable library 351 

modules 351 

link-edit statements 351 

delete statements 351 

assign alternate track disk. 351 

core image library 331 

phases 351 

relocatable library 351 

modules 351 

link-edit statements... 352 

delete statements 352 

assign alternate track data cell 352 

core image library 352 

phases 352 

relocatable library 352 

modules. 352 

link-edit statements 352 

delete statements 352 

clear disk. 352 

core image library 352 

phases 352 

relocatable library 352 

modules 352 

link-edit statements 352 

delete statements 352 

clear data cell 352 

core image library 352 

phases 352 

relocatable library 352 

modules 352 

link-edit statements 352 

delete statements ,,,... 352 

copy disk to card 352 

core image library 352 

phases. 352 

relocatable library 353 

modules 353 

link-edit statements... , 35 3 

delete statements 353 

copy disk to disk 353 

core image library 353 

phases 353 

relocatable library 353 

modules. , 35 3 

link-edit statements 3^3 

delete statements 353 

copy disk or data cell to tape 353 

core image library... 353 

phases 353 

relocatable library. 353 



modules 353 

link-edit statements *... 353 

delete statements 353 

copy and restore diskette 353 

core image library 3 53 

phase 353 

relocatable library 353 

module 353 

link-edit statements 353 

delete statements 353 

deblock utility 353 

core image library 353 

phase 353 

relocatable library 353 

modules 353 

link-edit statements 354 

delete statements 354 

fast copy disk volume 354 

core image library 

phases (integrated version) 3 54 

phase (standalone diskette 

version) 354 

relocatable library 

modules (integrated version) 354 

module (standalone diskette 

version) 354 

link-edit statements 

(integrated version) 354 

(standalone diskette version) 354 

source statement library 

(standalone versions) 354 

macro 354 

statements to obtain 

standalone card deck version 354 

statements to obtain 

standalone diskette version 354 

delete statements 354 

initialize disk « 354 

core image library 354 

phases 354 

relocatable library 354 

modules 354 

link-edit statements 354 

delete statements 354 

initialize data cell 355 

core image library 355 

phases 355 

relocatable library 355 

modules 355 

link-edit statements 355 

delete statements 355 

initialize tape 355 

core image library 355 

phase 355 
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relocatable library 355 

modules 355 

link-edit statements 355 

delete statements 355 

copy file and maintain object 
module 355 

core image library 355 

phase. 355 

relocatable library 355 

module 355 

link-edit statements 355 

delete statements. 355 

restore program 355 

core image library 355 

phase , 355 

relocatable library 355 

module 355 

link-edit statements 355 

delete statements 355 

backup program 355 

core image library 355 

phase 355 

relocatable library 356 

module 35o 

link-edit statements 35t 

delete statements 356 

source statement library 356 

maintain system nistory 356 

core image library. 356 

pnases 356 

relocatable library 356 

modules 356 

link-edit statements 356 

delete statements 356 

source statement library 356 

macros 356 

HIST macro description 356 

generation example 357 



list system history 357 

core image library 357 

relocatable library module 357 

link-edit statements 357 

delete statements 357 

restore card to disk 357 

core image library 357 

phase 357 

relocatable library 357 

modules 357 

link-edit statements 357 

delete statements 357 

restore tape to disk or data cell 357 

core image library 357 

phase 357 

relocatable library 357 

modules 357 

link-edit statements 358 

delete statements 358 

VTOC display 358 

core image library 358 

phase 358 

transient 358 

relocatable library 358 

modules (BJS) 358 

link-edit statements, 

non-multiprogramming system 358 

delete statements, 

non-multiprogramming system 358 

modules (MPS) 358 

link-edit statements, 

multiprogramming system 358 

delete statements, 
multiprogramming system 358 
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Module Index 

A 

analysis program-l 

delete statements... 351 

link-edit statements 351 

module names 351 

phase names 351 

assign alternate track data cell 

delete statements 352 

link-edit statements 352 

module names 351 

phase names 351 

assign alternate track disk 

delete statements 352 

link-edit statements 352 

module names 351 

phase names 351 



backup 

delete statements 355 

Imk-edat statements 355 

module names 356 

phase names 381 



clear data cell 

delete statements 352 

link-edit statements 352 

module names 352 

phase names 352 

clear disk 

delete statements 352 

link-edit statements 352 

module names 352 

phase names 352 

copy disk to disk 

delete statements 353 

link-edit statements 353 

module names 353 

phase names 352 

copy and restore diskette 

delete statements 353 

link-edit statements 353 

module names 353 

phase names ., 353 

copy disk or data cell to tape 

delete statements 353 

link-edit statements 353 

module names.. 353 

phase names 353 

copy disk tc card 

delete statements 353 

link-edit statements 353 

module names 353 

phase names 352 

copy file and maintain object 
module (OBJMAINT) 

delete statements , „. 355 

link-edit statements 355 

module names., 355 

phase names 355 



deblock 

delete statements 354 

link-edit statements 354 

module names 353 

phase names 353 



fast copy disk volume 

delete statements 354 

link-edit statements 354 

macro 354 

module names , 354 

obtain executable version 354 

phase names 354 

H 

HIST macro 356 

HISTLIST (list system history) 357 

I 

initialize data cell 

delete statements 355 

link-edit statements 355 

module names 355 

phase names 355 

initialize disk 

delete statements 354 

link-edit statements 354 

module names 354 

phase names 354 

initialize tape 

delete statements 355 

link-edit statements 355 

module names 355 

phase names 355 

L 

library requirements 351 

list system history 357 



M 



maintain system history (PTFHIST) 

delete statement, 356 

generation example 356 

HIST macro 356 

link-edit statements 356 

macros..... 356 

module names. 356 

phase names 356 



OBJHAINT (copy file and maintain 
object module) 
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P module names 357 

phase names 357 

PTPHIST (maintain system history) 356 

prelinked utilities 351 

T 

R transients, IBM-supplied 

$$BLVTOC 358 

restore 

delete statements 355 

link-edit statements 381 V 

module names 355 

phase names 355 VTOC display 

restore card to disk delete statements..... 35S 

delete statements 383 link-edit statements 358 

link-edit statements... 383 module names 358 

module names 383 phase names 358 

phase names 383 

restore tape to disk or data cell 

delete statements 357 

link-edit statements 358 
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Genera l 

System utilities are supplied prelinked in the core image library except the following: 

Maintain system History 
Assign Alternate Track Data Cell 
Clear Data Cell 
Initialize Data Cell and 
Print the Hard-Copy File 

For details on number of phases (modules, books) and number of blocks per library, refer 
to "Library Eequirements" in Moduls 1 of this manual. 

Instead of the link-edit and delet« statements given in this module of the manual, the 
IBM-supplied cataloged procedures may be used; refer to "Link-Edit and Delete Procedures" 
in Module 1. 



PARTITION SIZE 

Between 6K and e^+K of real storage 
depending on utility. Refer to DOS/V S 
System Utilities for details. 



Delete_Statements 

DELETR lAQMAP 
DELETR lAQMAPl 
DELETR IAQMAP2 
DELETR IAQMAP3 



Analysis Pit^iram-l 



Assign Attemate Trocli Disk 



^2RE_I«^3E_LIBRARy 

Phase 

API 

RELOCAIABLE LIBRARY 

Modules 

lAQMAP 
lAQNlAPl 
IAQMAP2 
IAQMAP3 

Link- Edit Staternents 

INCLUDE lAQMAP 
// EXEC LNKEDT 



CORE IMAGE LIBRARY 

Phases 

ALTDK 

ALrDK2 

ALTDK3 

ALTDKU 

ALTDK5 

RELOCATABLE LIBRARY 

Module s 

IJWATD 

IJWATDl 

IJWATD2 

IJWATD3 

IJrtATDU 

IJWATD5 
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Link-Edit Statements 

liSiCLaDE 13'^ATD 
// EXEC LNKEOr 

Delete statements 



DELETR 
DELETR 
DELETR 
DELETR 
DELETR 
DELETR 



IJ/JATD 

IJWATDl 

IJiJATD2 

IJ^ATD3 

IJWATD4 

IJWATD5 



Assign Alternate Track Data CeU 

CORE IMAGE LIBRARY 

Phases 

ALTDC 

ALTDC2 

ALTDCB 

ALTDCU 

ALTDC5 

RELOCArABLE_LIBRARY 

Modules 

IJi^ATM 

IJWATMl 

IJWATM2 

ij^ATiyia 

IJ^ATMU 
IJWAT[yl5 

Link-E3it_Statements 

INCLUDE IJWATM 
// EXEC LNKEDT 

Delete Statements 



DELETR 
DELETR 
DELETR 
DELETR 
DELETR 
DELETR 



IJWATM 

IJWATMl 

IJWATiyi2 

IJWATM3 

IJrfATMU 

IJWATM5 



Clear Disk 

CORE IMAGE LIBRARY 

Phases 

CLRDK 

CLRDK2 

CLRDK3 



RELOCATABLE LIBRARY 

Mod ules 

IJWCCD 
IJ;^/CCD1 
IJi^fCCD2 
IJWCCD3 

Lin k-Edit Statexiegts 

INCLUDE IJWCCD 
// EXEC LNKEDT 

D e 1 e t. e_ Statements 

DELETR IJWCCD 

DELETR IJ'^CCDl 

DELETR IJWCCD2 

DELETR IJWCCD3 



Clear Data CeU 

CORE IMAGE LIB RARY 

Phase s 

CLRDC 

CLRDC2 

CLRDC3 

RELOCATABLE^LIBRARY 

Modules 

IJi^CCM 
IJWCCMl 
IJ^CCM2 
IJWCCM3 

Link-Edit Statenents 



INCLUDE IJWCCM 
// EXEC LNKEDT 



Delete ^Statements 

DELETR IJWCCM 
DELETR IJWCCMl 
DELETR IJWCCM2 
DELETR IJWCCM3 



Copy Disk to Card 

CORE IMAGE LIBRAR Y 

Phases 

CDKCD 
CDKCD2 
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RELOCATABLE LIBRAR!<r 



Modules 



IJi^rCDC 

IJWCDGl 

IJ/JCDC2 



Link-Ejit .Statements 

INCLUDE IJ^CDC 
// LBLTYP NSD(nn) 
// EXEC LNKEDr 

Delete_StaLtements 

DELETR IJWCDC 
DELETR IJ^CDCl 
DELETR IJWCDC2 



Copy Disk to Disk 

^QRE_IMAGE_LIBRARY 

Pnases 

CDKDK 
CDKDK2 

R.ELOCArABLE_LIBRARX 
Modules 

IJi^CDD 

IJWCDDl 

IJWCDD2 

Link- Edit Statements 

INCLUDE IJ^CDD 
// LBLT!fP NSD(nn) 
// EXEC LNKEDI 

Delete Statements 

DELETR IJWCDD 
DELETR IJWCDDl 
DELETR IJWCDD2 

Copy Disk or Data Cell to Tape 



Mi;OC AT AB LE_LI B R AR Y 

Modules 

IJWCDT 

IJWCDTl 

IJ^CDr2 

Link-Edit Statements 

INCLUDE IJWCDT 
// LBLTYP NSD(nn) 
// EXEC LNKEDT 

Delete Statements 

DELETR IJWCDT 
DELETR IJWCDTl 
DELETR IJ>7CDT2 



Copy and Restore Diskette 

20EE_IMAGE_LIBt<ARY 

Phase 

CRDR 

REL OC AT AB LE _LI B R AR Y 

Module 

IJvNfCRD 

Link-Edit Statements 

PHASE CRDR.S 
INCLUDE IJWCRD 
// EXEC LNKEDT 

Dglgte Statements 

DELETR IJWCRD 

Deblock Utility 

CORE IMAGE LIBRARY 

Phase 

DSTRB 



^ORE_IMAGE_LIBRARY 

Phases 

CDKTP 
CDKrP2 



RELOCATABLE LIB RARY 

Modules 

IJWDST 
IJWDSTl 
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^itik-Edit gtatemerits 

INCLUDE IJWDST 
// LBLryp TAPE 
// EXEC LNKEDr 

Delete ^Statements 

DELETR IJMDST 
DELETR IJWDSTl 



Fast Copy Disk Volume 

2QEE_I>JME_LiBRARy 

Pbases (Integrated Version) 

FCOPY 
FC:0P!f2 

pnase (Standalone piskette_Version) 

DKTriPL 

RELOC?^Ii\BLE LIBRARY 

Modules . (Integrated_yersion ), 

IJWDFC 
IJWDFCl 

IJ/7DFC2 

Module (standalone D iskette^yersion) 

IJWDFCD 

Link-Edit ^Statements (I nt egrat ed y;ers ion ) 

// OPriON CATAL 

IWCLUDE IJWDFC 
// LBLPYP TAPE 
// EXEC LNKEDI 

LiQk'Edit^Staternents , (S t andalone Disk et te 
Version), 

// OPnON CAPAL 

INCLUDE IJWDFCD 
// LBLIYP TAPE 
// EXEC LNKEDT 



Statements^to_Qbtain Standalone_Card Deck 
Version 

// EXEC SSERV 

PUNCH Z.FASTCOPY 
/* 

St atejients_t o _Qbtain_Standalone Dis kett e 
Version 

// DLBL USYSPci 

// EXTENT 

// ASS3N SYS006,X'cuu' 

// EXEC DKTTIPL 

ASSGN SYSPCH,X*cuu' same diskette unit 

// EXEC SSERV 

PUNCH Z.FASTCOPD 

/♦ 

CLOSE SYSPCH,UA 

/& 

Qelete_Statements 

DELETC DKTTIPL 
DELETR IJMDFCD 
DELETR IJWDFC 
DELETR IJWDFCl 
DELETR IJWDFC2 
DELETS Z.FASTCOPY 
DELETS Z.FASTCOPD 



Initialize Disk 

CORE IMAGE LIBRARY 
Phases 



INTDK 
INTDK2 
INTDK3 
INTDKU 



RELOCATABLE LIBRARY 

Modules 

IJWIND 

IJWINDl 

IJWIND2 

IJHIND3 

IJWIND4 

Link -Edit ^S tat ements 

INCLUDE IJWIND 
// EXEC LNKEDT 



SOURCE STATEMENT LIBRARY (STANDALDNE 
VERSIONS). 

Macro 

Z.FASTCOPY (Card version) 
Z.FASTCOPD (Diskette Version) 



D e lete _Statements 

DELETR IJWIND 
DELETR IJWINDl 
DELETR IJWIND2 
DELETR IJWIND3 
DELETR IJWINDU 
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Initialize Data Ceil 



Copy File and Maintain Object Module 



;ORE IM^GE LIBRARY 



Phases 

INTDC 
INrDC2 
INTDC3 
INTDCU 



RELOCfi.rABLE LIBRARY 

Modules 

UWINM 
IJWINMl 
IJ/7INM2 
IJWI^I^13 

Linfc-Eait_ statements 

INCLUDE IJi^INM 
// EXEC LNKEDT 

Delete Statements 

DELETR IJrtlNM 
DELETR IJiATINMl 
DELETR IJ«INM2 
DELETR IJWINM3 
DELETR IJWINMU 



CORE IMAGE LIBRARY 

Phase 

OBJMAINT 

RELOCATABLE LIBRARY 

Module 

IJWOBJM 

Link-Edit S tat ements 

INCLUDE IJWOBJM 
// EXEC LNKEDT 

Delete Statements 
DELETE IJWOBJM 

Restore Program 

CORE IMAGE LIBRARY 
Phase 

RESTORE 



Initialize Tape 

^QEE_I?1AGE_LIBRARY 

Phase 

INTTP 

RELOCATABLE LIBRARY 

Modules 

IJWINT 
IJiJINTl 

Li nk-Edit_ Statements 

INCLUDE IJWINT 
// EXEC LNKEDT 

Delete _Statem ents 

DELETR IJi^JINT 
DELETR IJ^^INTl 



RELOCATABLE LIBRARY 

Module 

IJWSARST 

Link-Edit Stat eme nt s 

INCLUDE T.TMfiapfiT 
// EXEC LNKEDT 

Delete^Staternen t s 

DELETE IJHSARST 

Backup Program 

CORE IMAGE LIBRARY 

Phase 

BACKUP 
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RELOC^r^BLE_LIBRARY; 

Module 

IJWSABK 

Link-Edit Statennents 

include ij"^sabk 
// exe:: lnkedt 



HIST Macro Description 



Hisr REL=' release' ,CUST='name' 



[ , A.DDR= ' address ' ] [ , PHONE- ' numoer ' ] 

[ , PROG=' prDgra:n[ner' ] 

[ , ENV= ' environ.Tient ' ] 

[ , SCPHISr==SYSTEM j PRIVATE] 

[ , PPHIST=PRIVATE j SYSTEMi 



Delete sta tements 
DELETR iJv^SABK 
SQURCE_SrATEMENT_LIBRA.RY 
Z.BPSFILES 

Maintain System History 

CORE IMZ^GE LIBRARY 



'release' Specifies the SCP release to 

which this nistory belongs. A. 
character strinq up to 8 bytes 
long, enclosed in apostrophes. 



'nane' The customer's name (and number, 
if applicable) . h cnaracter 
string of up to 40 bytes, 
enclosed in apostropties. 



'address' The customer's address. A 

character string of up to 40 
bytes, enclosed in apostropnes. 



Phases 

PIFHISr 
PIFREPRO 



REtOCArABLE_LIBRARy 



Modules 

IKRSMPl 
IKRSMP2 
IKRSMP3 (generated by HIST macro) 



Link-Edit ^Statements 

Link-edit will be generated by HIST macro 
assembly. 



Pglgt.e Statements 

DELETR IKRSMPl 
DELETR IKRSMP2 
DELETR IKRSMP3 

SQtJRCE_SrALTEMENT_LIBRARY 

Macros 

E.HIST 
Y.PTFSCP 
Y.PTFPP 4S2 



'number' The customer's telephone number. 
A. character string of up to 40 
bytes, enclosed in apostropnes. 



' programmer ' 

The name of tne system 
programmer. A character string 
of up to 4 bytes, enclosed in 
apostrophes. 

* environment' 

Tne hardAfare/sof tware 
environment. A character string 
of up to 40 bytes, enclosed in 
apostropnes. 

CPHISr=S YSTEM I PRIVATE 

The source statement library in 
whicn the SCP history Y.PTFSCP 
is cataloged. If this operand 
is omitted, tne default is 
SYSTEM. 

PPHISr=PRIVATE I SYSTEM 

Tne source statement library in 
wnicn tne PP nistory Y.PTFPP is 
cataloged- If this operand is 
omitted, the default is PRIVATE. 

The output resulting from the BIST macro 
consists of job control statements for 
three steps: 

1. A step to update the history headers 
witn the customer information provided 
in the macro. 
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2. A step which catalogs an asseT[iblea 
module into the relocatable library. 
Tnis module then becomes part of tne 
D03/VS PrFHIST and contains inforiiation 
indicating wnere tne nistory Docks are 
cataloged. 

3. A final step i>?hicn catalogs tne DDS/VS 
PIFHIST into the core ituage library. 



feneration Example 

// JOB PIFHISr INSTALLATION 
// OPTION DECK 
// EXEC ASSEMBLY 

HIST REL=' 33. 0' , 

CUST^'EVA CORPORATION', 

ADDR='2 yi?^iN STREET, At^YviHERE' , 

PtiONE^' 017-723-977' , 

PROS---' TOM SMITti' , 

PPHIST=SZSTEM 



END 



/ + 
/& 



Previous entries in books Y.PTFSCP and 
Y.PTFPPj, except customer information, are 
retained. 



List System History 

Core Ima£e Library 

P]iase 

HISLIST 

RELCCATABLE LIBEAEY 

Module 

IKSHIST 



Restore Card to Disk 

^QRE_IMAGE_LIBRARy 

Pnase 

RCDDK 

RELOCArABLE_LIBRAR^ 

Modules 

IJ^RCD 
IJ^RCDl 

Link-Edit_Staternents 

INCLQDE IJWRCD 
// LBLT!^P NSD(nn) 
// EXEC LNKEDT 

Q§l§te_State[nents 

DELETR IJi^RCD 
DELETR IJi^RCDl 

Restore Tape to Disk or Data Cell 

CORE_IMAGE_LIBRARX 
Phase 

RTPDK 

RELOCATABLE_LIBRARY 

Modules 

IJWRTD 
IJWRTDl 



LiniS'ldit Statefflents 

INCLUDE IKEHIST 
// EXEC LNKEDT 



Link-Edit S tat e men ts 

INCLUDE IJWRTD 
// LBLT!fP NSD(IO) 
// EXEC LNKEDT 



JB^i§iS statements 
DELETE IKRHIST 



Delete Statements 

DELETR IJWRTD 
DELETR IJWRTDl 
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VTOC Display 

^O^E_IM^GE_ LIBRARY 

Phase 

LVTOC 

Transient 

$$BLVroc 

Note: $$BLVTOC is cataloged into the core 
image liorary along with tne VTOC program. 



REIiOC^r^BLE_LIBRARX 

Modules (BJS) 

IJi^LTVB 
IJWLTVT 
IJ^LTVl 

Link- Edit ..State jients^_Non-MultiBrogramnQing 
System 

INCLUDE IJWLTVB 
// LBLTlfP TAPE 
// EXEC LNKEDT 



Dgjigte_5tatements^ No n-Mul tiprogramming 
System 

DELETR IJWLTVB 
DELETR IJWLTVM 



Modules _XMP SI 

IJWLTVM 
IJWLTVT 
IJWLTVl 



Linic-Edit Statements, Multiprograiiming 
System 

INCLUDE IJ/^LTVM 
// EXEC LNKEDT 



Qglgte_State[nents^_Mu lti programming_Systenn 

DELETR IJWLTVM 
DELETR IJWLTVB 
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PARTiriON_SIZE 

The prograa requires a real partition 
allocation of 10K bytes. 

CORE I Mft.GE LI BRAR g 

r T 1 

I Phases | Blocks ) 
, + ^ ^ 

I Transients | 1 | 1 | 
|. + + ^ 

I I Phases | 131 j 344 | 

' L X X J 



rransi ents 

$$BSDRCJP 

Pnases 

EREP 

EREPADPr 
EREPASr?^ 
EREPCCH 
EREPCCHC 
EREPC125 
EREPC135 
EREPC145 
EREPDOLD 
EREPEDCP 
EREPEDCR 
EREPEDCO 
EBEPEDC1 
EBEPE0C2 
EBEPEDC3 
EREPEDDA 
EREPEDDK 
EBEFE0D1 
ESEFEDES 
EREPEDir 
EREPEDRN 
EREPEOrO 
EREPEDTP 
EREPEDTR 
EREPEDTl 
EREPEDUR 
EREPEDUl 
I EREPEDU2 
EREPEDVr 
EREPEDXl 
EREPEOD 
EREPESPr 
EREPESTR 
EREPESfrfK 
EREPHISI 
EREPIPL 
EREPMCAR 
EREPMCRC 
EREPMICR 
EREPMNTR 
EREPM1U5 
ESEPH158 
EREPROE 
EREPREPV 
EREPSdRT 



EREPSHRa 

EREPSMCP 

EREPSMCR 

EREPSMCU 

EBEPSHC1 

EBEPSHC3 

EREPSMOA 

EREPSHDK 

EREPSMDl 

ERBPSHES 

EREPSMRN 

EREPSMTD 

EREPSMTP 

EREPSMPR 

EREPSMTl 

EREPSMUR 

EREPSMUl 

EREPSMVr 

EREPSPCL 

EREPTES 

EREPTPEl 

EREPUCCM 

EREPUNIT 

EREPUOLD 

EREPVRNO 

EREPVRNl 

EREPVRN2 

EREPVRN3 

EREPVRN4 

SREPVRN5 

EREPVIAM 

EREPIUSA 

EREP145B 

EREP145C 

EREP145D 

EBEP158A 

EBEP158B 

EBEP158C 

EBEP158D 

EBEP158E 

EBEP1587 

EBEP158G 

EBEP158H 

EBEP158J 

£fiEP158K 

EBEP158L 

EBSP158H 

EBEP158M 

EBEP158P 

EBBP1580 

EREP2400 

EREP2715 

EBEP320X 

EBSP3203 

EREP3211 

EREP333M 

EREP333X 

EREP333Y 

EREP333Z 

EREP3330 

EREP3340 

EREP334W 

EREP334X 

£REP334]r 

EREP334Z 

EBBP335T 

EBEP335Z 

EBEP3350 
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EREP3aiO 
EREP3420 
EREP3500 
ERSP35aO 
EKEP3705 
EREP3800 
EREP3801 
SREP3802 
EREP3803 
EREP3804 
EREP3805 
EREP3806 
EREP3807 
EREP380X 
EREP389M 
EREP389N 
EREP389X 
EREP3895 



RELOCATABLE LIBRARY 



r T 1 

I Modules I Blocks | 

^ + ^ 

1 127 I 1,632 I 

i. X J 

Modules 

IJBEAD-Pr 

IJ BEAST A 

IJBECALA 

IJBECALB 

IJBECALC 

IJBECALD 

IJBECCH 

IJBECCHC 

IJBEC125 

iJBECl35 

IJBECIUS 

IJB£DOLD 

IJBEEDCP 

IJB£EDCH 

IJBEEDCO 

IJBESDC1 

IJB££DC2 

ZJBEEDC3 

IJB££DDA 

IJBEEDDK 

IJBEEDDl 

IJBEEDES 

IJBEEDir 

IJBEEDRiJ 

UBEEOTD 

IJBEEOIP 

IJBEEDTR 



IJBEEDTl 

IJBEEDUR 

IJBEEDUl 

IJBEEDU2 

IJBEEDVr 

IJBEEDXl 

IJBEEOD 

IJBEESPT 

IJBEESIR 

IJBEESWK 

IJBEHISI 

IJBEIPL 

IJBEMCAR 

IJBEMCRC 

IJBEMICR 

IJBEMNTR 

IJBEM145 

IJBEHISd 

IJBERDE 

IJBEBEF 

IJBERETV 

IJBESHRI 

IJBESHRU 

IJBESMCP 

IJBESMCR 

IJBESMCU 

IJBESHCI 

IJBESI1C3 

IJBESMDA 

IJBESMDK 

IJBESMDl 

IJBESMES 

IJBESMRN 

IJBESMID 

IJBESMIP 

IJBESMIR 

IJBESMPl 

IJBESMUR 

IJBESMUl 

IJBESMVr 

IJBESPCL 

IJBETES 

IJBETPEl 

I.JBEUCCM 

IJ8EUNIT 

IJBEUOLD 

IJBEVRHO 

IJBEVRNl 

IJBEVRtl2 

IJBEVRN3 

IJBEVRNf* 

IJBEVRN5 

IJBEVTAtt 

IJBE145A 

IJBE14 5B 

IJBE1<I5C 

XJBE145D 
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IJB£158A 
IJBE158B 
IJBE158C 
IJBE158D 
1JBE158E 
IJBE158F 
IJBE1586 
IJBE158B 
IJBE158J 
IJBE158K 
IJBE158L 
IJBE158I! 
IJBE158N 
IJBE158P 
IJBE1580 
IJBE2'400 
IJBE2715 
IJBE320X 
IJBE3203 
IJBE3211 
IJBE333Z 
IJBE3330 



IJBE33UZ 
IJBE33ttO 
IJBE335Y 
IJBE335Z 
IJBE3350 
IJBE3U10 
IJBE3U20 
IJBE3500 
IJBE35U0 
IJBE3705 
IJBE3800 
IJBE3-801 
IJBE3802 
IJBE3803 
IJBE3804 
IJBE3805 
IJBE3806 
IJBE3807 
IJBE380X 
IJBE389M 
IJBE3895 



Module 25; EREP — 5745-SC-ERP 362.1 



Li5lS~Edit_State[neQts 

INCLUDE IJBECALA 
// EXEC LNKEDT 

INCLUDE IJBECALB 

Retrieval) 
// EXEC LNKEOr 

INCLUDE UBECALC 
// EXEC LNKEDI 

INCLUDE IJBECALD 

Statistics) 
// EXEC LNKEDT 

INCLUDE IJBERDE 
// EXEC LNKEDT 



(Monitor) 
(Edit/Select 

(Summary) 
(rape Error 

(RDE Summary**) 



* 80 byte area reserved for tape label 
processing. mis procedure does away 
with the necessity of including a 
// LBLPYP card. 

** The sutntnary function will supply 
meaningful information only if 
ERRLOG=RDE is specified during systenn 
generation. 



Deletegtatements 

DELETR IJBEREP, IJBEADPT, IJBEASTA, etc. 
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General Index by Module 



5UFSIZE 1 

bypass initialize disk 1 



AB 1 

ABD 3 

abnormal termination exit (AB) 1 

ACANCEL 1 

access method services, DOS/VS 1, 17 

access method, virtual storage 1 

add unique library entries 1 

address specification during IPL 1 

ALIGN 1 

ALLOC 1, 22 

ALLOCE 1, 22 

allocate 1 

allocating library sizes 1 

alternate track assignment disk 24 

secondary storage requirements 1 
alternate track assignment data cell 



secondary storage requirements 1 
analysis program-1 1,24 
AP 1 
AP-1 1,24 
APBUF 22 
ASCII 1 
ASL 3 
assemble installation verification 

procedure 1 
assembler 18 

secondary storage requirements 1 
assembler work file 1 
ASSGN macro 1 

attention interrupt during IPL 1 
attention routines, initiators, 

terminators 1 
automatic documentation of supervisor 

generation macros 1 



B 



backup 24 

back-up of libraries 1 

backup utility 1 

basic supervisor generation macros 

basic QTAM logic modules 21 

BGPGE 1 

BGR 1 

BLKMPX 1 

block multiplexing support 1 

blocks per cylinder, system library 

BHPX 1 

BPSFILES 24 

BSCLNS 1 

BTAM 20 

secondary storage requirements 
BTMOD (BTAM logic module) , size of 
buffer pools, VTAM 22 



CAP 3 

card to disk 24 

secondary storage requirements 1 
cardless systems, machine reouirements 1 
catalog assembled supervisor 1 
CBF 1 
CCHAIN 1 

CDMOD (card module names for compilers) 1 
real storage requirements 7 
24 CHAN 1 

change supervisor contents 1 

CHANQ 1 

CHANSW 1 

CHAESET 1 

checkpoint/restart 1 

CHUN 1 

CIL patch program (PDZAP) 1 

clear data cell 24 

secondary storage requirements 1 
clear disk 24 

secondary storage requirements 1 
coding specification for // ASSGN 1 
command chaining (CCHAIN) 1 
common librarian modules 1 
compile a supervisor 1 
compiler IOCS modules 7 
component requirements 1 
component sizes 1 
computing the size of a supervisor 1 
CONFG macro 1 
configuration of IBM-supplied 

supervisors 1 
considerations for linking VTAM 22 
considerations for system generation 1 
console buffering 1 
copy and restore diskette 24 

secondary storage requirements 
copy disk or data cell to tape 24 
1 secondary storage requirements 

copy disk to c^rd 24 

secondary storage requirements 
copy disk to disk 24 

secondary storage requirements 
copy file and maintain object 
1 module 24 

secondary storage requirements 
copy system disk to tape 1 
copying selectively to merge libraries 1 
core image library 

assembler 18 
20 components 1 

CORGZ 1 



General Index by Module 365 



CSEBV 1 

directory 1 

DOC 1 

DSERV 1 

DUMPGEN 1 

EEEP 1, 25 

ESERV 1 

IBM 3211 printer support 

IBM-supplied 1 

IPL 1 

job control 1 

linkage editor 1 

MAINT 

MCAE/CCH 1 

CLTEP 19 

PDAIDS 1 

PDSDM 

EMS 1 

RSEEV 

SSEEV 

Standard system dump 1 

supervisor macros 1 

supervisor nucleus 1 

T/P, BTAM 20 

T/P, QTAM 21 

transients (see transients) 

translating system dump 1 

utilities (system) 24 
CORGZ 1 
creating a back-up of your generated 

system volume 1 
creating a third library from existing 

libraries 1 
cross-partition event control 1 
CSEEV 1 
CYL 1 
cylinder capacity, system library 1 



D 



DAMOD (direct access module names for 

compilers) 7 

real storage requirements 8 
DASDFP 1 
DATE 1 
DEC 1 
DECK 1 
declaring SYSEES libraries as private 1 

libraries 1 
define labels 1 

define the page data set (DPD) 1 
deleting entries and merging libraries 
DELUNSD 3 
DEFUSED 3 

device address specification 1 
device I/O modules requirements (QTAM) 
device type code 1 
DFTRMLST (define the terminal list 

BTAM) 20 
diagnostics 18 
DIMOD (device independent module names for 

compilers) 7 

real storage requirements 1 



directory capacit 
DISK 1 
disk EEP 1 
disk to card 24 
secondary stor 
disk to disk 24 
secondary stor 
disk work files 
assembler 18 
modules 7 
display operator 
display source of 
distribution tape 
DOC 1 
DOS/VS component 

requirements 1 
DPD macro 1 
DEMOD (3886 modul 
DSERV 1 
DTFBT (define the 

table 20 
DTFBTND (define t 

of table 20 
DTFCD (define the 

table 1 
DTFCN (define the 
DTFDA (define the 

device) 8 
DTFDI (define the 

system units) 
DTFDE table requi 
DTFDU (define the 
DTFIS (define the 

sequential) 10 
DTFME (define the 

reader) 11 
DTFHT (define the 

size of table 
DTFOE (define the 

size of table 
DTFPH (define the 

size of table 
DTFPE (define the 

table 1 
DTFPT (define the 
DTFQT (define the 
DTFSD (define the 

DASD) 16 
DTFSE (define the 
dumps 1 
DUMOD (diskette u 
DUMODFI 9 
DUMODFO 9 
DUMP 1 
DUMPGEN 1 
1 DVCGEN macro 1 
DVCTYP 1 
D2311 
D2314 
21 D2321 
D2400 
D3330 
D3340 
D3350 
D3410 
D3420 



ies, system 1 

age requirements 1 
age requirements 1 



console (DOC) 1 
supervisor 1 
1 

sizes and library 



e) 14 

file BTAM) , size of 

he file end BTAM) , size 

file card) , size of 

file console) 1 
file direct access 

file device independent 
1 
rements 14 

file diskette file) 9 

file indexed 

file magnetic character 

file magnetic tape) , 
12 

file optical reader) , 
13 

file physical IOCS) , 
1 

file printer) , size of 

file paper tape) 15 
file QTAM) 21 
file sequential 

file serial device) 1 

nit module) 9 
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I D3800 

D3886 
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G 



generated system volume 
GETVIS 1 

GETVIS area in SVA 1 
GRFlxxxx phases 1 



ECPREAL 1 

EDECK 1 

EMA 3 

EMANAHE 3 

EMATA 3 

EMATSN 3 

EMATYPE 3 

EMB 3 

EMBNAHE 3 

EMBTA 3 

EMBTSN 3 

emulator generation 1 

linkage editor statements 6 

module names and sizes 6 

modules, number of 6 
emulators, verification procedures for 
end of supervisor macro instruction, 

SEND 1 
environmental recording, editing, and 

printing program 1 
EPTDVT 22 
EREP 1, 25 
ERRLOG 1 
error statistics by tape volume 1 

2495 Tape Cartridge Reader 1 
ERRQ 1 
ERRS 1 
ESEEV 1, 18 
EU parameter 1 
EVA parameter 1 
example for system generation 1 
EXIT 1 
E20 3 
E20NAME 3 



failure in generating a system 

fast CCW translation 1 

FASTTE 1 

fast copy disk volume utility 

FETCH 1 

FIXPOOLS 22 

forced macros 1 

FOPT macro 1 

FP 1 

FnPGR 1 

Fn 1 

FnE 1 



1, 24 



H 



hard-copy file 1 
high-speed standalone dump 
HIST macro description 24 
HISTLIST 1, 24 



I 



I/O configuration, system generation 
example 1 

IBH-supplied libraries 1 

IBM DOS/VS distribution 1 

IBM 2314 work file requirements 1 

IBM 1403U buffer load 1 

IBM 3203 buffer load (IPL) 1 

IBM 3211 buffer load (IPL) 1 

IBM 3330 work file requirements 1 
I IBM 3800 support 1 

IBM 5203 buffer load (IPL) 1 
I lEBIMAGE utility 1 

initialize and restore programs 
bypass initialize disk 1 
initialize disk 1 
restore IBM tape to disk 1 

initialize data cell 24, 1 

initialize disk 24, 1 

initialize tape 24, 1 

installation verification procedure 
(see IVP) 

lOAPPN 22 

IOCS 

modules, compilers 1, 7 
modules, tape work files 7 

IOCS module sizes 
BTAM (BSC) 20 
BTAM (Start-stop) 20 
BTAM (transl. tables) 20 
compilers 7 
disk work files 7 

lODEV 1 

lOTAB macro 1 

IPL 1 

IPTADDE 3 

ISAM interface program 17 

ISMOD 7, 10 

IT parameter 1 

IVP 

assembly example 1 
creation of IVP stage II jobstream 
operating instructions 3 
optional SCP functions 3 
set-up requirements 3 
standard SCP functions 3 
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IVPGEN macro 
assembly 3 
execution 3 
parameters 3 



JA 1 

JALIOCS 1 

JIB 1 

job accounting interface 

job control 1 



K 



Kanji printer support ($$ABEERH 
transient) 1 



labels 1 

LFBUF 22 

librarian programs 1 

library block size 1 

library maintenance 1 

libraries on SYSEES file 1 

library sizes 1 

LINES 1 

linkage editing or deleting IBB 

components 1 
linkage editor 1 
LIST 1 

LIST (POWEE/VS parameter) 2 
list system history (HISTLIST) 1, 24 
LISTX 1 
listings 1 
LOAD 1 

loading the SDL 1 
loading the SVA 1 
loading VSAM phases 1 
LOG 1 

logical units 1 
LPBUF 22 
LSEEV 1 



M 



machine requirements 1 
macros for generating a 
supervisor 1 



macros, IBM 


-supplied 


ACB 17 




ALLOC 


1 


ALLOCE 


1 


ANUM U 


,5 


AEUMGTYP 


21 


AS 20 




ASCTE 


20 


ASLIST 


20 


ASSGN 


1 


BDYBOX 


1 


BEGIN 


23 


BLDVRP 


17 


BPSFILES 


2U 


BEEAKOFF 


21 


BTBONLT 


20 


BTBTEIH 


20 


BTBTFIX 


20 


BTBTFBEE 


20 


BTBTEOD 


20 


BTBTRSCH 


20 


BTCEMODE 


20 


BTCKID 


20 


BTCONST 


20 


BTCSE 


20 


BTCTOPT 


20 


BTMOD 


20 


BTM0DIH1 


20 


BTM0DIH2 


20 


BTNCKID 


20 


BTOLTCMP 


20 


BTOLTIH 


20 


BTONLAP 


20 


BTOMLOA 


20 


BTRD 20 


BTE];.BF 


20 


BTEQBF 


20 


BTRWC 


20 


BTTEANS 


20 


BTWAIT 


20 


BUFARU 


21 


BUFFER 


21 


CCB 1 




CANCELM 


21 


CDMOD 


1 


CHANGE 


22 


CHECK 


1 


CHECKAEU 


21 


CHGNTRY 


20 


CHKPT 


1 


CHNGP 


21 


CHNGT 


21 


CHREQ 


21 


CLOSE 


1 


CLOSEHC 


21 


CLOSER 


1 


CLSDST 


22 


CNTEL 


1 


CONFG 


1 


CONFIGOB 


20 


CONTEOL 


20 


COPYC 


21 


COPYP 


21 


COPYQ 


21 


COPYT 


21 


COUNTER 


21 


CETAEX 


1 
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CRTAWT 1 
CRTGEN 1 
CETGBOUP 20 
CRTIO 1 
CRTSAV 1 
CTLTBL 21 
CTELIST 20 
CTRSCHED 20 
DAMOD 7,8 
DAMODV 8 
DATESTMP 21 
DEULIST 20 
DEQB 17 
DISP 1 
DFi? lU 
DFTMRLST 
DIMOD V 
DIRECT 21 
DISEN 11 
DISPGUID 20 
DLINT 14 
DLINTIN 
DLVRP 17 
DO 22 



20 

7 



14 



1 



DPD 

DBMOD 

DSPLY 

DSUB 

DTFBG 

DTFBT 

DTFCD 

DTFCN 

DTFDA 

DTFDI 

DTFDR 

DTFDU 

DTFEN 

DTFIS 

DTFMR 

DTFMT 

DTFOR 

DTFPH 

DTFPR 

DTFPT 

DTFQT 

DTFSD 

DTFSR 

DUMODFI 

DUMODFO 

DVCGEN 1 

EMUDI 6 

EM1403 6 

EM1442 6 

EM20CHK 

EM20CCNV 

EM20CPU 

EM20DI 6 

EM20END 

EM20MESS 

EM20PEHD 

EM20SYS 

EM20VBIF 

EM2152 

EM2203 

EM2311 

EM2400 

EM2501 



14 
13 
4, 5 
1 

20 
1 
1 
8 
1 

14 
9 
1 

10 
11 
12 
13 
1 
1 

1, 15 
21 
16 
1 



EM2520 6 
EM2560 6 
ENDFL 10 
ENDINTAB 22 
ENDQB 17 
ENDECV 21 
ENDEEADY 21 
ENDBEQ 17 
ENDSEND 21 
EOA 21 
EOB 21 
EOBLC 21 
ERASE 17 
EEET 1 
ERBMSG 21 
ESETL 10 
EXCP 1 
EXECRPL 22 
EXLST 17 
FASTCOPD 24 
FASTCOPY 24 
FEOV 1 
FEOVD 1 
FOPT 1 
FREE 1 
GDUAS 20 
GDULIST 20 
GDUTRANS 20 
GENCB 17 
GET 1 
IFGACB 22 
IFGEXLST 22 
IFGRPL 22 
IHBEDWRA 22 
IISCR 6 
IISDC 6 
IISEDB 6 
IJLQDEQU 21 
IJLODSCT 1, 21 
IJLQTSVC 1, 21 
IKQACB 17 
IKQACBG 17 
IKQCB1 17 
IKQCB2 17 
IKQEEMAC 17 
IKQEXLG 17 
IKQEXLST 17 
IKQEPL 17 
IKQRPLG 17 
INQUIRE 22 
INTAB 22 
INTERCPT 21 
INTERPRET 22 
lOINTER 1 
lOTAB 1 
ISMOD 7, 10 
ISTACB 22 
ISTACBG 22 
ISTAVT 1 
ISTBLDO 22 
ISTCBHTB 22 
ISTCB1 22 
ISTCB2 22 
ISTBIND 22 
ISTDNIB 22 
ISTDPOHD 22 
ISTDPROC 22 
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ISTDVCHR 22 
ISTEXLG 22 
ISTEXLST 22 
ISTBDWRA 22 
ISTEPL 22 
ISTBPLG 22 
ISTNSSBG 22 
IVPASLC 18 
IVPASLS 18 
IVPE20C 6 
IVPOLTC 19 
JDUMP 1 
LB RET 1 
LCBD 21 
LDO 22 
LERB 20 
LERPRT 20 
LINE 21 
LINETBL 21 
LIST 21 
LITE 11 
LOGCHAR 22 
LOGSEG 21 
LOPEN 20 
LPSTABT 21 
HAPCCMR 1 
MA PES PI B 1 
MAPLOWC 1 
HAPPUB2 1 
MCEAS 1 
MCR1 11 
MCR2 11 
MODCB 17 
MODE 21 
MODEEND 22 
MODEENT 22 
HODETAB 22 
MRMOD 11 
MSGTYPE 21 
MTMOD 7, 12 
MOLDIV 4 
NETSOL 22 
NIB 22 
NOTE 1 
ONLTST 20 
OPCTL 2 1 
OPEN 1 
OPENB 1 
OPNDST 22 
OPTION 21 
OBDC 13 
OEJT 13 
OEMOD 13 
PABAHNUH 20 
PAEMLIST 20 
PAUSE 21 
PIOCS 1 
PLINE 2 
POINT 17 
POINTB 1 
POINTS 1 
POINTW 1 
POLL 21 
POLLIMIT 21 
POST A BO 21 
POSTECV 21 
POSTSEND 21 



POWER 1 
PREPIXD 21 
PRMOD 1, 7 
PROCESS 21 
PBTOV 1 
PTFPP 2a 
PTFSCP 24 
PTMOD 15 
PUT 1 
PUTB 1 
QCBD 21 

I QSETPRT 1 
RCVCMD 22 
RCVHDR 21 
RCVITA2 21 
RCVSEG 21 
RCVZSC3 21 
RDLNE 13 
READ 1 
RECEIVE 22 
RELBUF 20 
RELEASE 1 
RELEASER 21 
EELSE 1 
REPEAT 21 
REQBUF 20 
REROUTE 21 
RESCN 13 
RESET 22 
RESETPL 20 
RESETSE 22 
RETRIEVE 21 
EMSRTAB 20 
ROUTE 21 
RUNMODE 1 
RPL 17 
SAMP327L 20 
SAMP327R 20 
SCANREQ 20 
SDMOD 7 
SDMODFI 16 
SDMODFO 16 
SDMODFU 16 
SDMODUI 16 
SDMODOO 16 
SDMODUU 16 
SDHODVI 16 
SDMODVO 16 
SDMODVU 16 
SDMODW 16 
SDETAB 20 
SECTVAL 1 
SEND 1 
SENDCHD 22 
SENDHDE 21 
SENDSEG 21 
SEOV 1 
SEQIN 21 
SEQOUT 21 
SESSIONC 22 
SETDEV lU 
SETFL 10 
SETL 10 
SETLOGON 22 

I SETPRT 1 
SGAH 1 
SGCCWT 1 
SGDFCH 1 
SGDSK 1 
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SGEND 


1 




SGPMAIN 


1 




SGPOPT 


1 




SGPSUB 


1 




SGSCVKT 


1 




SGSVC 


1 




SGSVCX 


1 




SGTHAP 


1 




SHOWCAT 


17 




SHCWCB 


17 




SIMLOGOK 


1 22 




SKIP 21 




SMICR 


1 




SNDITA2 


21 




SNDZSC3 


21 




SOLICIT 


22 




SOURCE 


21 




STARTARU 


1 21 




STARTLN 


21 




STCBD 


21 




STDJC 


1 




STEND 


20 




STOPARO 


21 




STOPLN 


21 




SUPVR 


1 




SYSIO 


1 




TCLOSE 


17 




TERM 21 




TEEMTBL 


21 




TERMTBLI 


1 21 




TESTCB 


17 




TG ROUP 


20 




TIMESTME 


21 




TPEDIT 


20 




TRANS 


21 




TRANSLAI 


20 




TRLIST 


20 




TENSLATI 


: 20 




TRSRCTH 


20 




TRSRCT3 


20 




TESSCTW 


20 




TESSCT3 


20 




TRUNC 


1 




TTIMEB 


1 




TWAIT 


20 




USSCMD 


22 




USSEND 


22 




USSMSG 


22 




USSPAiiM 


22 




USSTAB 


22 




VSTAB 


1 




WAITF 


1 




WOBD 21 




WORDTBL 


21 




WRITE 


1 




WRTBFR 


17 




WRU 21 






macros requrired and 


forced 1 


nain page pool size 


1 


■agnetic tape IOCS modules 7 


main page pool size 


1 


MAI NT 1 






maintain system history (PTFHIST) 24 


secondary storage 


requirements 1 


maintenance 


of libraries 1 


maps 1 






BCAE/CCH 


1 





1 



MCH 1 

MERGE function, use of 

MICR 1 

minimum machine requirements 1 

MNOTES during supervisor assembly 

MODE 1 

MODEL 1 

niodulenumber suffix for CPO 1 

MEMOD (magnetic character reader 

module) 13 
MESLCH 1 

MTMOD (magnetic tape module) 7,12 
multitasking 1 



N 



NPARTS 1 
NPBUF 22 
NRfiS 1 



o 



OBJMAINT 24 
OC parameter 1 
OLT 3 
OLTEP 19,1 
operational pack 1 
operational DOS/VS not available 1 
OPNAPPL 22 
OPNCLS 22 

optical reader sample problems 13 
organization of the system pack 1 
OEMOD (optical reader module) , size of 
13 



page data set dump (PDSDH) 


1 


page pool, main 1 




PAGEIN 1 




PAGPOOLS 22 




parameters 




ALLOC 1 




ALLOCR 1 




ASSGN 1 




CONFG 1 




DPD 1 




DTFBT table requirements 


formula 


DVCGEN 1 




FOPT 1 




lOTAB 1 




IVP 3 




PIOCS 1 




POWER 1 




SEND 1 





2D 
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STDJC 1 
SUPVE 1 
I TRC 7 

VSTAB 1 

partition save areas 1 

patch program (PDZAP) 1 

PC 1 

PCHADDfi 3 

PCIL 1 

PD 1 

PDAID 1 

PDSDM 1 

PDZAP 1 

performance of FETCH and LOAD 1 

PFIX 1 

PHO 1 

physical and logical I/O assignments 1 

physical transient overlap (PTO) 1 

PIOCS 1 

PL/I, IOCS modules 7 

planning 

libraries (operational pack) 1 
supervisor 1 
system generation 1 

POWEE parameter in SUPVE 1 

POWEE/VS 

computing size of supervisor 1 
core image library blocks 1 
installation, documentation for 1, 2 
installation verification procedure 3 
macros 1 

POWEE parameter in SUPVE macro 1 
relocatable library blocks 1 
required and forced options with 

POWEE=YES 1 
source statement library blocks 1 
supervisor real storage requirements 1 
with EJE^SNA 1 

PPBUF 22 

prelinked utilities 24 

printer support, IBM 1403U, 3203, 3211, 
I 3800, and 5203 1 

PBINTLOG utility 1 

private libraries 1 

private second level directories 1 

PEMOD (printer module) 1,7 

problem determination, IBM-supplied list 
for DOS/VS 1 

procedures 1 

processing the distribution tape 1 

programs for system generation and 
maintainance, example of use 1 

PETY 1 

PET1 1 

PSEEV 1 

PSLD 1 

PSSNKA 22 

PTFHIST 2^ 

PTMOD (paper tape module) 15 

PTO (physical transient overlap) 1 

PWE 3 



I QSETPRT macro 1 
QTAM 21 
QTAM secondary storage requirements 



R 



EDE (reliability data extractor) 1 

EDT 22 

real address area 1 

real storage allocation 1 

recorder file 1 

reliability data extractor (EDE) 1 

EELLDE 1 

relocatable library 

assembler 18 

BTAM 20 

common librarian modules 1 

compiler IOCS modules 7 

COEGZ 1 

CSEEV 1 

DSEEV 1 

DDMPGEN 1 

emulator modules, library blocks 6 

EEEP 1 

ESEEV 1 

ESTVUT 1 

IBM 3211 printer support 1 

IPL 1 

job control 1 

linkage editor 1 

LSEEV 1 

MAINT 1 

MCAE/CCH 1 

module ID 1 

OLTEP 19 

PDAID 1 

PDSDM 1 

PSEEV 1 

QTAM 21 

EMS 1 

ESEEV 1 

SSEEV 1 

standard system dump 1 

translating system dump 1 

utilities 2U 
relocating load support 1 
replacing identical entries 1 
required IOCS modules 7 
required macros 1 
EEEUN 3 
restore 24 

secondary storage requirements 1 
restore back-up tape to disk 1 
restore card to disk 24 

secondary storage requirements 1 
restore libraries 1 
restore system tape to disk 1 
restore tape to disk or data cell 24 

secondary storage requirements 1 
EETAIN 1 
EMS (EEELOG) 1 
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EPGII IOCS modules 7 

RPL-oriented macro instruction storage 22 

EPS 

deletion of EPS support 1 

preloading modules in the SVA 1 
ESEEV 1 
ESIZE 1 
rules 

ASSGN 1 

DVCGEN 1 

macros 1 

supervisor generation macros (basic) 1 
RWTAU 1 



SDAID 1 

SDL considerations 1 

SDMOD (sequential DASD modules) 7, 16 

SDMODW 7 

SDMODxx 7 

search order for phases 1 

second level directory 1 

SELCH 1 

selection of IBM-supplied supervisors 1 

SKND macro 1 

SET SDL 1 

SETIME 1 

SETPRT macro 1 

shared virtual area (SVA) 1 

size of compiler IOCS modules 7 

size of libraries 1 

size of main page pool 1 

size of supervisor 1 

SKSEP 1 

SLD 1 

SMSBUF 22 

SNT 22 

source statement library 1 

source statement library macros 

BTAM 20 

components of 1 

QTAM 21 

supervisor generation 1,11 

system generation 1 
source statement library, IBM-supplied 1 
SP 1 
SPAEM 1 
SPBUF 22 
SETADD 22 
SSEEV 1 
SSLNS 1 
SSS 23 

Standalone dump, high-speed 1 
standard label option 1 
standard system dump 1 

status inf ormation on system libraries 1 
STDJC 1 
storage requirements for DOS/VS 

programs 1 
STXIT 1 

subsystem support services 23 
suffix for CPU model specification 1 
supervisor selection 1 



supervisors shipped by IBM 1 

SITPVE macro 1 

SVA 1 

switchable channels 1 

SYM 1 

symbolic device name assignment 1 

symbolic programmer units, maximum 1 

SYNCH 1 

synchronous exit 1 

SYSALOAD 22 

SYSDEF 22 

SYSFIL 1 

SYSRES file 1 

system configuration 1 

system directory and library track 

capacities 1 
system directory list (SDL) 1 
system distribution 

disk users 1 

tape users 1 
system generation and maintenance 

procedure 1 
system I/O modules MTMOD 7 
system libraries 

directory capacities 1 

track capacities 1 
system utility program 1, 24 



table requirements 

DTFCD 1 

DTFCN 1 

DTFDA 11 

DTFDI 1 

DTFDU 9 

DTFIS 10 

DTFMR 11 

DTFMT 12 

DTFOE 13 

DTFPH 1 

DTFPB 1 

DTFPT 15 

DTFSD 16 

DTFSE 1 

DDMODFI 9 

DUHODFO 9 
TAPE 1 
tape EEP 1 

tape to data cell 1, 24 
tape to disk 1, 24 
tape to workfiles 

assembler 18 

modules 7 
task timer support (TTIWE) 1 
TEE 1 
TEBV 1 

teleprocessing (see BTAH, QTAM, or VTAM) 
time-of-day (TOD) clock support 1 
TOD 1 

TOLTEP (see VTAM) 1 
TP 1 
track capacity of system library 1 
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transients. 


IBM- 


supplied 


$$A$SUP1 






$$ABERAA 






$$ABEEAB 






$$ABERAC 






$$ABERAD 






$$ABZRAE 






$$ABEEAF 






$$ABERAG 






$$ABERAH 






SSABERAI 






$$ABERAN 


• / 


14 


$$ABEEAO 






$$ABERAP 






$$ABERAQ 






$$ABERAE 






$$ABERA1 






$$ABESA2 






$$ABEEA3 






$$ABEEA4 






$$ABERA5 






$$ABERA6 






$$ABEEA7 






$$ABERP1 




20 


$$ABEEP2 




20 


$$ABEEP3 




20 


$$ABEEP4 




20 


$$ABEEP5 




20 


$$ABEEP6 




20 


$$ABEEP7 




20 


$$ABEEP8 




20 


$$ABEEP9 




20 


$$ABERRA 






$$ABEBRB 






$$ABEEEC 
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